---
name: new-project
description: 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.
license: 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:

   ```bash
   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`):

   ```bash
   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.