project-template: Skill for Claude Code

Convierte esta plantilla en el repositorio del proyecto real. Es un proceso de una sola vez.

Antes de empezar

1. Lee todos los archivos de docs/.
2. Si no existe .template/ y los documentos tienen contenido, el repo ya está inicializado. Dilo y no toques nada, salvo que el usuario pida rehacer algo concreto.
3. Si los documentos están vacíos o incompletos (solo comentarios, sin contenido real), no escribas código ni inicialices todavía:
   • Pregunta: "¿Qué quieres construir y para quién?"
   • Con la respuesta, carga /documentacion: decide qué documentos necesita el proyecto, dilo antes de empezar a preguntar y rellénalos en el orden que indica, confirmando cada uno.
4. Con los documentos rellenos, sigue con lo de abajo. Cuando termines, pregunta "¿Empezamos a construir?"; no antes.

Datos que necesitas

Pregunta solo lo que no puedas deducir de docs/:

• Nombre del proyecto y descripción de una línea
• Estado actual (En desarrollo / Beta / Producción)
• Autor y año para la licencia

Qué hacer

Antes de tocar nada, abre AGENTS.md con la herramienta de lectura. Cuando se carga solo al empezar la sesión, Claude Code le quita los comentarios <!-- ... -->, y ahí es justo donde están los placeholders y los ejemplos que vas a sustituir.

1. README.md — reescríbelo entero para el proyecto, a partir de lo que hay en docs/. Debe explicar el producto, no la plantilla. Estructura sugerida: nombre y descripción de una línea, qué problema resuelve, requisitos previos, variables de entorno (referencia a .env.example), instalación y desarrollo (pnpm install, pnpm dev), estructura de carpetas, cómo contribuir (referencia a AGENTS.md y al protocolo) y estado del proyecto. Los badges de la cabecera apuntan al repositorio de la plantilla: quítalos o repóntalos al del proyecto.
2. AGENTS.md — rellena nombre, descripción, estado, stack, estructura de carpetas, convenciones y "Qué NO hacer". El contenido real va fuera de los comentarios, o el agente no lo verá. Borra los comentarios que ya no apliquen, la sección "Inicialización del proyecto", el paso 2 de "Estado del proyecto y arranque" (el de .template/ y los docs vacíos, renumerando el siguiente) y la mención a .template/ del protocolo de cambios. El "Protocolo de MCPs" se queda: sigue aplicando cada vez que entre una integración nueva. CLAUDE.md no se toca: solo importa AGENTS.md y añade lo específico de Claude Code.
3. LICENSE — sustituye la línea de copyright de la plantilla por el año actual y el titular de este proyecto.
4. .env.example — deja solo las variables que el stack elegido necesita de verdad.
5. MCPs — pregunta qué servidores MCP quiere y con qué alcance, siguiendo el "Protocolo de MCPs" de AGENTS.md. Si prefieres tratarlo aparte, lanza /mcp-setup.
6. docs/ — borra los documentos que este proyecto no necesite, según /documentacion. Los que no aplican se borran, no se dejan vacíos. docs/features/ se queda vacía, solo con su README.md.
7. mejoras/backlog.md — borra el ejemplo comentado y déjalo listo para entradas reales.
8. Borrados — .template/ entera (es el historial de la plantilla, no del proyecto) y esta misma skill, .claude/skills/init-proyecto/, que deja de tener sentido una vez hecha. Enseña antes la lista exacta de lo que va a desaparecer y espera confirmación. Después quita las referencias que queden a .template/assets/ (hay una en docs/features/README.md) y a /init-proyecto (en README.md y AGENTS.md).
9. changelog/ — debe quedar sin entradas heredadas. Crea la primera entrada real del proyecto (tipo: Configuración) con /changelog y quita de changelog/README.md la referencia a la plantilla, o borra el archivo.
10. Restos — busca referencias sobrantes y corrige cada una que hable de la plantilla en lugar del proyecto: grep -ril "plantilla\|template" . --exclude-dir=.git --exclude-dir=node_modules
11. Comprobación final — pasa /diagnostico: documentación, entorno, variables, MCPs y tests. Si algo sale en FALLO, arréglalo antes de dar la inicialización por terminada.