---
context: Unificar las skills del ecosistema de agentes en background en una sola skill `agent-orchestrator`, manteniendo separadas `aleleba-pr`, `docmost-context` y `web-ui-test`.
---

# Plan: Consolidar skills de agentes en `agent-orchestrator`

## Contexto

Actualmente el ecosistema de agentes en background está fragmentado en **7 skills + 1 comando** separados:

| Skill | Archivo | Función |
|-------|---------|---------|
| `agent-orchestrator` | `.claude/skills/agent-orchestrator/SKILL.md` | Orquestador principal (trigger, fases, referencias) |
| `agent-launcher` | `.claude/skills/agent-launcher/SKILL.md` | Flujo de lanzamiento (detectar proyecto, crear worktree, tmux, Docmost) |
| `agent-monitor` | `.claude/skills/agent-monitor/SKILL.md` | Monitoreo de sesiones (JSONL, tmux, desbloqueo) |
| `agent-instructions` | `.claude/skills/agent-instructions/SKILL.md` | Template TASK.md para agentes autónomos |
| `agent-archiver` | `.claude/skills/agent-archiver/SKILL.md` | Validación y archivo de agentes completados |
| `agent-safety` | `.claude/skills/agent-safety/SKILL.md` | Reglas de seguridad compartidas |
| `agent-troubleshooting` | `.claude/skills/agent-troubleshooting/SKILL.md` | Tabla de problemas conocidos y soluciones |
| `aprobar` | `.claude/commands/aprobar.md` | Comando para validar/archivar agentes |

Las siguientes **3 skills se mantienen separadas** (no se consolidan):
- **`aleleba-pr`** — Pipeline de entrega (commit, push, PR). Referenciada por el orquestador pero con lógica independiente.
- **`docmost-context`** — Carga de contexto del proyecto desde Docmost. Se activa automáticamente vía hook.
- **`web-ui-test`** — Pruebas de UI con Playwright headless. Referenciada en el checklist de TASK.md.

## Plan de ejecución

### Paso 1: Unificar contenido en `agent-orchestrator/SKILL.md`

Crear un nuevo archivo `.claude/skills/agent-orchestrator/SKILL.md` que contenga **todo** el flujo de agente en background, organizado en secciones claras:

1. **Trigger** — Cuándo activarse (frases del usuario)
2. **Reglas de seguridad** — Reglas de merge, atribución a Claude, aislamiento (de `agent-safety`)
3. **Fase 1: Lanzar** — Flujo completo de `agent-launcher` (detectar proyecto, crear worktree, tmux, Docmost, verificación)
4. **Fase 2: Monitoreo** — Checks de `agent-monitor` (JSONL, tmux, desbloqueo, send-keys)
5. **Fase 3: Instrucciones del agente** — Template TASK.md de `agent-instructions` (incluye email SMTP, checklist, reglas de git, Docmost)
6. **Fase 4: Archivo** — Flujo de `agent-archiver` (leer Docmost, integrar docs, borrar subpágina, merge, cleanup)
7. **Troubleshooting** — Tabla de problemas conocidos de `agent-troubleshooting`
8. **Referencias** — Links a las 3 skills que se mantienen separadas (`aleleba-pr`, `docmost-context`, `web-ui-test`)

### Paso 2: Eliminar archivos de skills obsoletas

Eliminar los siguientes archivos:

- `.claude/skills/agent-launcher/SKILL.md`
- `.claude/skills/agent-monitor/SKILL.md`
- `.claude/skills/agent-instructions/SKILL.md`
- `.claude/skills/agent-archiver/SKILL.md`
- `.claude/skills/agent-safety/SKILL.md`
- `.claude/skills/agent-troubleshooting/SKILL.md`
- `.claude/commands/aprobar.md` — **NO ELIMINAR**, mantener este comando

### Paso 3: Actualizar referencias cruzadas

Verificar que no queden referencias a las skills eliminadas en ningún otro archivo del proyecto. Las únicas referencias que deben quedar son:
- Dentro de `agent-orchestrator/SKILL.md` (referencia a `aleleba-pr`, `docmost-context`, `web-ui-test`)
- En el hook `~/.claude/hooks/docmost-session-start.sh` (referencia a `docmost-context`)

### Paso 4: Verificar

- Confirmar que `agent-orchestrator/SKILL.md` es autocontenido y funcional
- Verificar que no hay archivos huérfanos referenciando las skills eliminadas
- Confirmar que las 3 skills excluidas (`aleleba-pr`, `docmost-context`, `web-ui-test`) siguen intactas y funcionales