feat: paquete pi-new-project con la skill new-project

This commit is contained in:
sargatxet committed 2026-10-18 13:34:20 +02:00
commit b35bc7a607
14 files changed
+716

No files matched your search

+57
View File
@@ -0,0 +1,57 @@
---
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. Ú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. **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.
4. **Ajusta** `INSTALL.md` con los requisitos y pasos reales del stack elegido.
5. **Commit inicial** si se creó repo git:
```bash
git add -A && git commit -m "docs: base documental inicial"
```
6. Informa al usuario de la ruta creada, los ficheros y del commit.
## 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` 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.
- `templates/` — plantillas con marcadores `{{PROYECTO}}`, `{{DESCRIPCION}}`,
`{{AUTOR}}`, `{{FECHA}}`, `{{FECHA_ISO}}`.
- `references/plantillas.md` — qué contiene cada documento y cuándo tocarlo.