release v0.3.0 (origen c00f020)

2026-10-18 18:58:51 +02:00
commit 2df23d5b33
@@ -0,0 +1,88 @@
+# AGENTS.md
+
+Guía para agentes y colaboradores que trabajen en **{{PROYECTO}}**.
+Léela antes de tocar cualquier fichero y respétala en cada cambio.
+
+## Propósito del proyecto
+
+{{DESCRIPCION}}
+
+## Contenido del repositorio
+
+| Ruta | Descripción |
+| --- | --- |
+| `AGENTS.md` | Este documento: reglas de trabajo. |
+| `README.md` | Visión general y puesta en marcha. |
+| `INSTALL.md` | Instalación detallada y dependencias. |
+| `CHANGELOG.md` | Historial de cambios (*Keep a Changelog*). |
+| `TODO.md` | Tareas pendientes y deuda técnica. |
+| `.pi/settings.json` | Ajustes de pi del proyecto: modelo por defecto. |
+| _(completar)_ | Añade aquí el código y los recursos del proyecto. |
+
+## Reglas de modelo
+
+### Modelo por defecto
+
+El modelo por defecto del proyecto se guarda en `.pi/settings.json`
+(`defaultProvider` y `defaultModel`) y pi lo aplica al iniciar cada sesión nueva
+en este directorio (requiere haber confiado en el proyecto: `/trust`).
+
+- Para cambiarlo: `/modelo-proyecto` (muestra los modelos disponibles) o
+  `/modelo-proyecto proveedor/id`.
+- No edites a mano ni cambies ese modelo sin que lo pida el usuario.
+- `.pi/settings.json` se versiona; un cambio de modelo se commitea como
+  cualquier otro cambio.
+
+### Otras reglas
+
+PENDIENTE: definir el contexto y el criterio de selección de modelos por tarea
+(coste, VRAM, ventana, velocidad). Se acuerda tarea por tarea; hasta entonces,
+no fijar valores aquí.
+
+## Reglas de funcionamiento
+
+PENDIENTE: definir flujo de trabajo, estándares de código, comandos obligatorios,
+política de ramas y de revisión, y cualquier automatización propia del proyecto.
+
+## Reglas obligatorias
+
+1. **Todo cambio se documenta y se commitea.** Cada vez que se modifique
+   cualquier fichero del repositorio:
+   - Añadir una entrada en `CHANGELOG.md` (fecha, versión y tipo:
+     `Añadido` / `Cambiado` / `Corregido` / `Eliminado`).
+   - Actualizar `TODO.md` si el cambio abre, cierra o modifica tareas.
+   - Actualizar `README.md`, `INSTALL.md` o los documentos que correspondan si
+     cambia el comportamiento, la instalación o el uso.
+   - Crear **un commit de git** con mensaje claro en imperativo.
+2. **Nunca dejar documentación desfasada.** Si el código y los documentos no
+   coinciden, el cambio está incompleto.
+3. **No commitear** secretos, binarios, artefactos de build, logs ni dependencias
+   descargadas (`.gitignore` cubre lo básico; amplíalo según el stack).
+4. **Idioma: español** para documentación, mensajes de commit y comentarios.
+
+## Verificación antes de commitear
+
+PENDIENTE: sustituir por los comandos reales del stack (formato, tipos, tests,
+lint). Ningún commit sin verificación en verde.
+
+```bash
+# ejemplo
+# make check
+```
+
+## Flujo de trabajo
+
+1. Editar los ficheros necesarios.
+2. Ejecutar las verificaciones anteriores.
+3. Actualizar `CHANGELOG.md`, `TODO.md` y la documentación afectada.
+4. `git add -A && git commit -m "tipo(alcance): descripción breve"`.
+5. Informar del cambio y del hash del commit.
+
+## Convención de mensajes de commit
+
+`tipo(alcance): resumen` — tipos: `feat`, `fix`, `docs`, `chore`, `refactor`,
+`test`, `build`, `perf`.
+
+Ejemplos:
+- `docs: documentar instalación y puesta en marcha`
+- `feat(api): añadir búsqueda paginada`