44 lines
2.6 KiB
Markdown
44 lines
2.6 KiB
Markdown
# Plantillas de la base documental
|
|
|
|
Qué genera `new-project.sh` y cuándo hay que tocar cada documento.
|
|
|
|
| Documento | Para qué sirve | Cuándo actualizarlo |
|
|
| --- | --- | --- |
|
|
| `AGENTS.md` | Reglas de trabajo para agentes y colaboradores: flujo, commits, verificación y las futuras reglas de modelo y de funcionamiento. | Al cambiar el flujo, las reglas, los comandos de verificación o al fijar las reglas de modelo. |
|
|
| `README.md` | Puerta de entrada: qué es el proyecto, estado, instalación rápida, uso y estructura. | Al cambiar el propósito, el uso o la estructura. |
|
|
| `INSTALL.md` | Instalación reproducible: requisitos, dependencias, configuración, verificación, arranque, actualización y desinstalación. | Al añadir dependencias, variables de entorno o cambiar pasos de instalación. |
|
|
| `CHANGELOG.md` | Historial *Keep a Changelog*: `Añadido` / `Cambiado` / `Corregido` / `Eliminado`. | En cada cambio, sin excepción. |
|
|
| `TODO.md` | Tareas en curso, pendientes y hechas, incluida la deuda técnica. | Al abrir o cerrar tareas. |
|
|
| `.gitignore` | Exclusiones básicas: secretos, dependencias descargadas, artefactos de build, logs. | Al detectar ficheros que no deben versionarse. |
|
|
| `.pi/settings.json` | Modelo por defecto de pi para el proyecto (`defaultProvider`, `defaultModel`). Lo crea `elegir_modelo_proyecto` o `--modelo`. | Solo con `/modelo-proyecto`, a petición del usuario. |
|
|
|
|
## Marcadores
|
|
|
|
El script sustituye estos marcadores en todas las plantillas:
|
|
|
|
| Marcador | Valor |
|
|
| --- | --- |
|
|
| `{{PROYECTO}}` | `--nombre` o, si falta, el nombre del directorio destino. |
|
|
| `{{DESCRIPCION}}` | `--descripcion` o un `PENDIENTE` explícito. |
|
|
| `{{AUTOR}}` | `--autor` o `git config user.name`. |
|
|
| `{{FECHA}}` y `{{FECHA_ISO}}` | Fecha de ejecución en formato `AAAA-MM-DD`. |
|
|
|
|
## Secciones reservadas
|
|
|
|
`AGENTS.md` incluye a propósito dos secciones con `PENDIENTE`:
|
|
|
|
- `## Reglas de modelo` — explica dónde está el modelo por defecto y cómo
|
|
cambiarlo; el criterio de selección por tarea queda `PENDIENTE`.
|
|
- `## Reglas de funcionamiento` — estándares, ramas, revisión y automatización.
|
|
|
|
No se rellenan al generar el proyecto: se acuerdan después, proyecto a proyecto.
|
|
|
|
## Modelo por defecto
|
|
|
|
- Al crear el proyecto, el usuario elige el modelo en el selector de la
|
|
herramienta `elegir_modelo_proyecto` (alternativa: `--modelo proveedor/id`).
|
|
- Se guarda en `<proyecto>/.pi/settings.json`; pi lo aplica en cada sesión nueva
|
|
del proyecto si éste es de confianza.
|
|
- Se cambia en cualquier momento con `/modelo-proyecto`, que fusiona el valor con
|
|
el resto de ajustes del fichero y activa el modelo en la sesión actual.
|