# .agents/ — Skills y Orquestación

## Skills incluidas (pinned — no dependen de servicios externos)

```
.agents/skills/
├── test-driven-development/SKILL.md    ← obra/superpowers (pinned 2026-03-19)
├── systematic-debugging/SKILL.md       ← obra/superpowers (pinned 2026-03-19)
├── code-review-excellence/SKILL.md     ← community + checklist V4 BIAN (pinned 2026-03-19)
├── documentation-writer/SKILL.md       ← community + OpenAPI V4 (pinned 2026-03-19)
└── security-best-practices/SKILL.md    ← community + banking patterns (pinned 2026-03-19)
```

**¿Por qué están congeladas?** Para evitar que una actualización upstream cambie el comportamiento esperado. Estas versiones fueron validadas contra el patrón V4.

**¿Cuándo actualizarlas?** Solo cuando el equipo revise la nueva versión upstream y confirme que es compatible con los patrones del proyecto.

---

## Orquestación Multi-Agente (V5 — activar cuando proceda)

Para implementar orquestación, ver `docs/guia-v5-advanced-ai-architecture.md §3 y §4`:

```
.agents/
├── orchestrator.md      ← director (NUNCA hace trabajo real, solo coordina)
├── agents/
│   ├── spec-writer.md
│   ├── designer.md
│   ├── impl-rec.md
│   ├── impl-bus.md
│   ├── test-writer.md
│   └── reviewer.md
└── contracts/
    ├── spec-output.md
    ├── design-output.md
    └── review-output.md
```

### Herramientas
- **Agent Teams Lite:** https://github.com/Gentleman-Programming/agent-teams-lite
- **Engram (memoria persistente):** `npx -y @gentleman-programming/engram`