# 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) | — |
