refactor: comandos a skills, /doctor a /diagnostico y CLAUDE.md de 308 a 231 líneas

[polmarza]

¿Qué se hizo?

Dos commits sobre el andamiaje de la plantilla:

1. Claude Code ha fusionado los comandos personalizados con las skills. Los seis comandos de .claude/commands/ pasan a .claude/skills/<nombre>/SKILL.md con frontmatter (name, description con cuándo usarla, argument-hint). /doctor se renombra a /diagnostico porque el /doctor nativo es ahora una skill y la del proyecto lo sustituía.
2. CLAUDE.md baja de 308 a 231 líneas (sin contar comentarios <!-- -->, que Claude Code no carga). El flujo de arranque pasa a /init-proyecto, la tabla de documentación a una skill nueva /documentacion, y se recortan el ciclo de feature y los protocolos de cambios y PR.

Motivación

• Las skills se cargan solas cuando su description encaja con la tarea; los comandos solo si alguien los invoca. Eso permite mover procedimientos fuera de CLAUDE.md sin perderlos.
• La guía oficial recomienda CLAUDE.md por debajo de 200 líneas y los procedimientos de varios pasos en skills.
• El checklist de inicialización estaba duplicado en CLAUDE.md y en /init-proyecto.

Requisitos que cierra

Ninguno (cambio interno sobre el andamiaje).

Tipo de cambio

• Feature
• Fix
• Refactor
• Migración
• Documentación
• Configuración

Evidencia

$ node scripts/verificar-cobertura.mjs; echo "exit=$?"
Sin fichas de feature todavía: nada que verificar.
exit=0

$ git log --oneline origin/main..HEAD
473ac97 refactor: CLAUDE.md pasa de 308 a 231 líneas y la tabla de docs a una skill
c0e7196 refactor: los comandos pasan a skills y /doctor pasa a /diagnostico

$ git diff --stat origin/main..HEAD | tail -1
 15 files changed, 370 insertions(+), 227 deletions(-)

Sin código de aplicación: no hay tests que ejecutar. Lo que no está comprobado todavía es el flujo real de arranque con un proyecto nuevo; es lo que se va a probar tras abrir este PR.

Verificación de los requisitos:

Requisito	Se validó con	Resultado
(ninguno)	Claude Code lista las seis skills con su description en la sesión; grep sin referencias a .claude/commands/ ni a secciones eliminadas de CLAUDE.md fuera del changelog histórico	OK

Qué conviene mirar al revisar

• CLAUDE.md conserva una condición explícita (si existe .template/ o docs/ está vacío, carga /init-proyecto). Si esa skill no se cargara, el agente podría escribir código con los docs vacíos: es el riesgo principal y lo que hay que probar.
• Se pierde algo de precisión en la regla "qué doc actualizar ante cada cambio" (tabla nueva → data-model.md, etc.), ahora más genérica.
• CLAUDE.md sigue por encima de las 200 líneas; bajar más implicaría sacar reglas, no procedimientos.
• No se ha tocado AGENTS.md; es una decisión de alcance aparte.

Checklist

• Los documentos afectados en docs/ están actualizados (docs/architecture.md; README y CLAUDE.md también)
• La ficha de docs/features/ está en estado Verificada: no aplica, no hay fichas
• Hay una entrada en changelog/ con este cambio: está en .template/changelog/ (dos entradas), no en changelog/, porque el repo sigue siendo la plantilla
• La sección "Evidencia" contiene salida real de comandos, no una descripción de lo que pasaría
• Se ha ejecutado /security-review: no se ha ejecutado; no hay cambios sensibles (sin código, claves ni permisos)

🤖 Generated with Claude Code

https://claude.ai/code/session_012dc5DmuFemQZNBZWdN3Wux

---

Generated by Claude Code