inq-roi-simulador-web/methodology

Método de trabajo con agentes de IA

Versión de trabajo. Nombre definitivo pendiente.

Estado: borrador en construcción. Los patrones se validan en proyectos reales antes de promoverse a versión estable.

---

Qué es esto

Es el método interno de trabajo para construir software con agentes de IA (Claude Code y otros) manteniendo gobernanza, calidad y aprendizaje acumulado.

Hipótesis central: los agentes de IA permiten producir software 5-10× más rápido que un desarrollador solo, pero sin gobernanza producen deuda invisible que cuesta más caro de la que se ahorra. Este método es el sistema de gobernanza.

Qué NO es

• No es un manual de Claude Code. No enseña a usar la herramienta.
• No es una metodología ágil reemplazante. Es complementario a Scrum/Kanban/lo que uses.
• No es opcional dentro de InQuality cuando el output va a cliente o producción.

Para quién

• Desarrolladores con experiencia técnica (programadores, ingenieros, analistas) que ya entienden conceptos de software (commits, tests, refactor, deuda técnica).
• Líderes técnicos que orquestan equipos pequeños (2-10 personas) trabajando con agentes.

Cómo se usa este repositorio

Lectura en orden recomendado:

1. PRINCIPLES.md — los 5 principios fundamentales. Es lo único memorizado obligatorio.
2. PATTERNS.md — los patrones operativos derivados. Es referencia, no memoria.
3. ANTI_PATTERNS.md — qué evitar y por qué. Útil para detectar problemas en flagrante.
4. TEMPLATES/ — scaffolds reutilizables para no empezar de cero.
5. CASE_STUDIES/ — proyectos reales aplicando el método. El primero es InQ ROI Sprint 1.5.

Cómo contribuir

Si descubrís un patrón nuevo o un anti-patrón:

1. Documentalo en su archivo correspondiente con la estructura existente
2. Citá el contexto real donde lo encontraste (proyecto + sprint)
3. Pull request con revisión de al menos otra persona del equipo

Los patrones se validan en al menos 2 proyectos distintos antes de promoverse de "propuesto" a "estable".

Estado actual de madurez

Sección	Estado	Próxima revisión
Principios	Borrador inicial — 5 derivados de InQ ROI	Después de Sprint 2 con otro proyecto
Patrones	12 identificados, marcados como propuestos	Promover a estable los que se apliquen en 2do proyecto
Anti-patrones	5 identificados, todos en flagrante real	Estables — son daño documentado
Templates	3 disponibles (Brief, Prompt etapa, Reporte)	Iterar con uso real
Case studies	1 en construcción (InQ ROI Sprint 1.5)	—