feat: modelo por defecto por proyecto con selector y orden /modelo-proyecto
This commit is contained in:
1 parent
b35bc7a607
commit
f6d2870635
12 files changed
+372
-22
No files matched your search
@@ -1,6 +1,6 @@
|
||||
---
|
||||
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.
|
||||
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
|
||||
---
|
||||
|
||||
@@ -28,22 +28,37 @@ Genera el esqueleto documental de un proyecto. Todas las plantillas están en
|
||||
|
||||
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
|
||||
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.
|
||||
4. **Ajusta** `INSTALL.md` con los requisitos y pasos reales del stack elegido.
|
||||
5. **Commit inicial** si se creó repo git:
|
||||
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"
|
||||
```
|
||||
6. Informa al usuario de la ruta creada, los ficheros y del commit.
|
||||
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` y `## Reglas de funcionamiento` de
|
||||
- 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.
|
||||
@@ -52,6 +67,8 @@ Genera el esqueleto documental de un proyecto. Todas las plantillas están en
|
||||
## 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.
|
||||
Reference in new issue
Block a user