docs(methodology): commit inicial del método de trabajo con agentes

methodology/README.md

@@ -0,0 +1,54 @@
+# 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) | — |