Un veterano de la ingeniería de software ha desarrollado una solución que pretende resolver uno de los grandes desafíos actuales en el desarrollo asistido por inteligencia artificial: cómo proporcionar a los agentes de codificación el contexto suficiente para que trabajen de manera eficiente y estructurada.
La herramienta, publicada bajo licencia Apache 2.0, es una plantilla de repositorio que establece un flujo de trabajo riguroso desde las fases previas a la codificación. En lugar de saltar directamente a la implementación, este enfoque estructura meticulosamente los objetivos del proyecto, historias de usuario, requisitos, y decisiones arquitectónicas antes de que el código sea escrito.
El creador, pangon, cuenta con 25 años de experiencia como investigador de informática e ingeniero full-stack trabajando principalmente en startups. Durante años ha utilizado esta metodología en proyectos personales, y ahora la ha empaquetado como una plantilla reutilizable, convencido de que puede resultar valiosa para otros desarrolladores que trabajan con herramientas de IA como Claude Code.
**La arquitectura del sistema**
La plantilla organiza la orientación de la IA en tres capas distintas, cada una optimizada para el uso eficiente de la ventana de contexto, un recurso limitado en los modelos de lenguaje actual.
La primera capa comprende archivos de instrucción (CLAUDE.md y variantes temáticas) que permanecen siempre cargados en memoria pero se mantienen deliberadamente pequeños. Estos describen la estructura del repositorio, mantienen índices de artefactos y definen reglas transversales, como invariantes de trazabilidad.
La segunda capa consiste en "habilidades" (skills) almacenadas en el directorio .claude/skills, que se cargan bajo demanda. Cada una contiene procedimientos paso a paso para actividades específicas del ciclo de vida del desarrollo de software: elicitar requisitos, análisis de brechas, diseño arquitectónico, descomposición en componentes, planificación de tareas e implementación.
La tercera capa agrupa los artefactos del proyecto en archivos markdown estructurados que se acumulan conforme avanza el trabajo: partes interesadas, objetivos, historias de usuario, requisitos, suposiciones, restricciones, decisiones, arquitectura, modelo de datos y diseño de API. Estos se consultan selectivamente a través de índices, no en su totalidad.
Esta separación es fundamental porque los archivos de instrucción deben ser lean para permanecer en la ventana de contexto permanentemente, las habilidades pueden ser detalladas porque se cargan solo cuando son necesarias, y los artefactos del proyecto escalan con la complejidad, pero se navegan mediante tablas indexadas en lugar de lectura completa.
**La captura de decisiones y el flujo secuencial**
Uno de los aspectos más innovadores de esta plantilla es cómo aborda la captura y persistencia de decisiones. Cada determinación tomada durante el razonamiento de la IA y el feedback humano se almacena como un artefacto estructurado, lo que garantiza que sea revisable, trazable y se aplique consistentemente en sesiones futuras.
El flujo de trabajo sigue una estructura esencialmente secuencial, inspirada en metodologías waterfall. Aunque este enfoque puede resultar tedioso para equipos humanos, los agentes de IA no padecen el mismo cansancio y, lo que es más importante, la estructura explícita previene el fracaso común del "simplemente empezar a codificar sin dirección clara".
El creador utiliza sesiones cortas y enfocadas, donde cada sesión invoca una habilidad específica, produce su salida y termina. Esta organización del conocimiento permite que la siguiente sesión continúe sin perder contexto. Ha observado que el prompting libre entre habilidades es generalmente un indicador de que el flujo de trabajo carece de algún componente necesario.
**Limitaciones actuales y perspectivas**
Antes de su lanzamiento, el autor reconoce una limitación notable: no ha encontrado una manera efectiva de integrar diseños de UI/UX existentes procedentes de Figma en el flujo de trabajo, y está abierto a sugerencias de la comunidad.
La publicación de este scaffold llega en un momento en que la industria aún experimenta con la mejor manera de estructurar el desarrollo de software completamente asistido por IA. Mientras algunos abogarán por mantener la flexibilidad creativa, esta propuesta sugiere que la eficiencia y la trazabilidad podrían conseguirse mediante una metodología rigurosa y bien documentada, demostrando que no todos los agentes de IA necesitan libertad absoluta para generar código de calidad.
