release v0.3.0 (origen c00f020)

skills/new-project/references/plantillas.md

@@ -0,0 +1,43 @@
+# 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.