Muchos están programando con IA ahora, usando quizás Claude Code, Cursor, Copilot, GPT-Codex, etc.
Pero hay algo que casi nadie menciona…
Si tu proyecto está desordenado, la IA tampoco lo va a entender bien.
Una forma simple de organizar un proyecto cuando trabajas con IA:
📁 src/ → código de tu aplicación
📄 CLAUDE.md (contexto del módulo)
📁 docs/ → documentación técnica
📄 architecture.md
📁 decisions/
📁 runbooks/
📄 CLAUDE.md → contexto global del proyecto
📁 .claude/ → configuración del agente
📄 settings.json
📁 hooks/
📁 skills/
📁 code-review/
📁 refactor/
📁 release/
📁 tools/ → utilidades del proyecto
📁 scripts/
📁 prompts/
La idea es simple:
Separar código, documentación, contexto de IA y automatizaciones.
Cuando el proyecto está bien organizado:
• la IA entiende mejor tu código
• reutilizas instrucciones
• automatizas tareas
• desarrollas mucho más rápido
Programar con IA no solo es usar prompts. También es organizar bien tu proyecto.