pi-new-project/skills/new-project/SKILL.md

name, description, license

name	description	license
new-project	Genera la base documental de un proyecto nuevo (AGENTS.md, README.md, CHANGELOG.md, TODO.md, INSTALL.md y .gitignore) a partir de plantillas, y deja que el usuario elija el modelo por defecto del proyecto. Úsala cuando el usuario pida crear un proyecto, repositorio o directorio nuevo, inicializar su documentación o "montar el esqueleto" de un repo.	MIT

new-project

Genera el esqueleto documental de un proyecto. Todas las plantillas están en templates/ y el andamiaje lo hace scripts/new-project.sh.

Procedimiento

1. Recoge los datos que falten antes de ejecutar nada:

   • ruta de destino (obligatoria);
   • nombre del proyecto (por defecto, el nombre del directorio destino);
   • descripción en una frase (obligatoria: se usa en README y AGENTS);
   • autor (opcional; por defecto git config user.name);
   • si hay que inicializar un repositorio git (--git). No inventes la descripción: si el usuario no la da, pregúntala o propón una y confírmala.

2. Ejecuta el script desde este directorio de skill:

   scripts/new-project.sh --nombre "Mi Proyecto" --descripcion "Qué hace" \
     --git /ruta/al/proyecto
   

   El script no sobreescribe ficheros existentes salvo con --force y muestra un resumen de lo creado. Usa --dry-run para revisar antes.

3. Modelo por defecto del proyecto (obligatorio): el usuario elige el modelo de entre los existentes; tú no lo eliges.

   • Llama a la herramienta elegir_modelo_proyecto con ruta = destino del proyecto. Muestra al usuario el selector con los modelos disponibles y guarda su elección en <ruta>/.pi/settings.json (defaultProvider y defaultModel). pi lo usará en todas las sesiones nuevas del proyecto.
   • Si la herramienta no existe o no hay interfaz: ejecuta pi --list-models, enséñale la lista al usuario, pregúntale cuál quiere y guárdalo con scripts/new-project.sh --modelo proveedor/id <destino> (solo crea .pi/settings.json si no existe).
   • Si el usuario cancela, déjalo sin fijar e indícale que puede hacerlo más tarde con /modelo-proyecto.

4. Revisa el resultado: abre README.md y AGENTS.md del proyecto generado y completa lo que quede como PENDIENTE (objetivos, stack, comandos de verificación reales). No dejes marcadores de plantilla ni secciones vacías.

5. Ajusta INSTALL.md con los requisitos y pasos reales del stack elegido.

6. Commit inicial si se creó repo git (incluye .pi/settings.json):

   git add -A && git commit -m "docs: base documental inicial"
   

7. Informa al usuario de la ruta creada, los ficheros, el modelo elegido, el commit y de que puede cambiar el modelo en cualquier momento con /modelo-proyecto dentro del proyecto.

Reglas

• No ejecutes el script sobre un directorio que ya tiene AGENTS.md o README.md sin avisar y confirmar (usaría --force).
• Las secciones ## Reglas de modelo (salvo el modelo por defecto, que gestiona /modelo-proyecto) y ## Reglas de funcionamiento de AGENTS.md se dejan como PENDIENTE a propósito: se acuerdan después, por proyecto. No las rellenes con suposiciones.
• Idioma de los documentos generados: español.
• Rutas relativas siempre desde este directorio de skill.

Referencia

• scripts/new-project.sh --help — todas las opciones.
• /modelo-proyecto [proveedor/id] — cambia el modelo por defecto del proyecto del directorio actual (sin argumento, muestra el selector).
• templates/ — plantillas con marcadores {{PROYECTO}}, {{DESCRIPCION}}, {{AUTOR}}, {{FECHA}}, {{FECHA_ISO}}.
• references/plantillas.md — qué contiene cada documento y cuándo tocarlo.