55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
# 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) | — |
|