qwen3-6-lora/data/raw/sanitized/plans/puedes-revisar-la-skill-linear-cray.md

context

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