# Specs

Todo trabajo nuevo no trivial empieza aquí, antes de programar. Eso incluye
una funcionalidad, un rediseño o cualquier cambio que toque la base de datos,
los permisos o las cuotas. Los bugs pequeños no necesitan spec.

## Estructura

```
specs/NNN-tema/
├── spec.md     qué y por qué
├── plan.md     cómo
├── review.md   revisión (por ejemplo, de Codex); opcional
└── tasks.md    checklist de implementación
```

`NNN` es un número correlativo (`001`, `002`…) y `tema`, unas pocas palabras
en minúsculas separadas por guiones. Es la misma estructura que usa Spec Kit,
por si algún día se quiere usar esa herramienta.

## Reglas

- **Solo contenido técnico.** Precios, facturación y qué contarle a EWC van
  fuera del repo, en `../encargos/`.
- El orden es `spec.md` → `plan.md` → `tasks.md`. Carla aprueba la spec y el
  plan antes de implementar.
- En `tasks.md`, cada tarea es un commit. Una tarea se marca como hecha cuando
  está probada, no cuando está escrita.
- Al terminar, se marca la spec como hecha en su cabecera y lo que siga
  valiendo pasa a `docs/` (cómo funciona, decisiones), a `CHANGELOG.md` y a
  `docs/status.md`. La spec queda como historia; la verdad actual está en
  `docs/`.

## Plantillas

### spec.md

~~~markdown
# NNN · Título

Estado: borrador | aprobada | en curso | hecha · Fecha:

## Problema
Qué pasa hoy y a quién le afecta.

## Comportamiento esperado
Qué debe pasar, para cada rol afectado (admin, profesor, alumno).

## Criterios de aceptación
- [ ] Cada uno, comprobable por separado.

## Fuera de alcance
Lo que esta spec no hace.

## Decisiones abiertas
Lo que falta decidir y quién lo decide.
~~~

### plan.md

~~~markdown
# NNN · Plan

## Cambios
- Base de datos (modelos, migración):
- Backend (rutas, servicios, permisos):
- Frontend (pantallas, componentes, textos en es y en):

## Riesgos y compatibilidad
Qué se puede romper y cómo se evita.

## Pruebas
Cómo se comprueba cada criterio de aceptación.

## Despliegue
Migraciones, orden de los pasos y cómo volver atrás.
~~~

### tasks.md

~~~markdown
# NNN · Tareas

- [ ] 1. … (commit: )
- [ ] 2. …
~~~
