65 lines
3.9 KiB
Markdown
65 lines
3.9 KiB
Markdown
---
|
|
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
|