Fase 2: 04_sanitize.py - scrubbing de secretos de skills/agentes/plans (10 secretos unicos, gate en verde)

2026-07-29 00:35:59 +00:00
parent 21bc219f31
commit 837f91060f
79 changed files with 10153 additions and 0 deletions
@@ -0,0 +1,64 @@
+---
+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