Created
January 2, 2026 22:04
-
-
Save jorgeucano/e6dee98f365a7e92b9a189011d7515b3 to your computer and use it in GitHub Desktop.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Necesito que analices este proyecto y generes la infraestructura completa para trabajar eficientemente con Claude Code siguiendo las mejores prácticas. Hacé lo siguiente: | |
| ## 1. CLAUDE.md (raíz del proyecto) | |
| Analizá el código, estructura, dependencias y patrones del proyecto. Generá un CLAUDE.md que incluya: | |
| - Descripción del proyecto y su propósito de negocio | |
| - Stack tecnológico y versiones principales | |
| - Estructura de directorios con explicación de cada carpeta importante | |
| - Convenciones de código (naming, patrones, arquitectura) | |
| - Comandos esenciales (build, test, lint, deploy) | |
| - Flujo de trabajo del equipo (branches, PRs, CI/CD) | |
| - Errores comunes a evitar (basado en lo que veas en el código) | |
| - Contexto de negocio relevante para entender decisiones técnicas | |
| ## 2. .claude/commands/ | |
| Creá slash commands para workflows comunes. Mínimo estos archivos: | |
| - `pr.md` - Crear un PR con descripción, tests y changelog | |
| - `review.md` - Revisar código buscando bugs, seguridad y mejoras | |
| - `test.md` - Generar tests para un archivo o función específica | |
| - `refactor.md` - Refactorizar código manteniendo funcionalidad | |
| - `docs.md` - Generar/actualizar documentación | |
| - `debug.md` - Investigar y solucionar un bug | |
| - `feature.md` - Implementar una feature desde plan hasta PR | |
| Cada comando debe incluir instrucciones claras, el formato de output esperado, y pasos de verificación. | |
| ## 3. .claude/settings.json | |
| Configurá permisos seguros pre-aprobados basándote en las herramientas del proyecto: | |
| - Comandos de lectura (cat, ls, find, grep, etc.) | |
| - Comandos del package manager detectado (npm, yarn, pnpm, pip, etc.) | |
| - Comandos de git seguros (status, diff, log, branch) | |
| - Linters y formatters del proyecto | |
| - Comandos de test | |
| - Cualquier CLI específica que detectes (kubectl, docker, mongosh, etc.) | |
| NO incluyas comandos destructivos ni con side-effects peligrosos. | |
| ## 4. .claude/agents/ | |
| Creá subagentes especializados: | |
| - `code-simplifier.md` - Simplificar y limpiar código sin cambiar funcionalidad | |
| - `security-check.md` - Auditoría de seguridad del código | |
| - `verify.md` - Verificar que los cambios funcionan correctamente | |
| ## 5. .claude/hooks/ (documentación) | |
| Creá un archivo `hooks-setup.md` explicando cómo configurar: | |
| - PostToolUse hook para formateo automático con el formatter del proyecto | |
| - Stop hook para verificación automática en tareas largas | |
| ## 6. .mcp.json (si aplica) | |
| Si detectás integraciones que podrían beneficiarse de MCP servers (Slack, bases de datos, APIs), creá un template de .mcp.json con la estructura comentada. | |
| ## 7. README de .claude/ | |
| Creá `.claude/README.md` explicando toda la estructura generada y cómo el equipo puede contribuir/modificarla. | |
| --- | |
| IMPORTANTE: | |
| - Adaptá todo al contexto REAL de este proyecto, no uses placeholders genéricos | |
| - Usá el estilo y convenciones que ya existen en el código | |
| - Si encontrás documentación existente, integrala | |
| - Verificá que los comandos que pre-apruebes realmente existan en el proyecto | |
| - Poné ejemplos concretos basados en el código real | |
| Empezá analizando el proyecto y después generá cada archivo. Mostrá el plan antes de ejecutar. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment