Índice de archivados

# Índice de changes archivados — [Nombre del proyecto]

> Plantilla de Argui. Vive **junto a lo que indexa**: la carpeta de archivo de OpenSpec
> (`openspec/changes/archive/README.md` en una instalación estándar). La escribe el agente de
> progreso/documentador en el stage `archive`, junto con la actualización de progreso — crea el
> archivo si no existe y **agrega una fila** por cada change. Log histórico **append-only**: las
> filas pasadas no se reescriben.
>
> Responde una sola pregunta: **¿dónde está la historia de esta capability?** No es el backlog
> (qué falta y en qué estado) ni el CHANGELOG del producto (qué ve el usuario, por versión).
> Ver [workflow.md](../methodology/workflow.md) `F5.1` y [openspec.md](../methodology/openspec.md).

| ID | Fecha | Título | Capabilities / specs | RF | Regla aprendida |
|---|---|---|---|---|---|
| [PRJ-014] | [AAAA-MM-DD] | [una línea: qué se construyó] | [auth, sesiones] | [RF-2, RF-7] | [→ destino, o —] |

## Cómo se llena

- **ID** — el ítem del backlog que originó el change. Enlaza a su carpeta archivada; es el mismo
  ID que va en el nombre de la rama (`feat/PRJ-014-login`) y en el diagrama de dependencias.
- **Capabilities / specs** — qué tocó. Es la columna por la que realmente se busca meses después,
  y la primera parada de una arqueología puntual (ver
  [brownfield.md](../methodology/brownfield.md)).
- **RF** — los requisitos que satisface. Continúa la cadena de trazabilidad: insignia del
  prototipo → spec → change.
- **Regla aprendida** — **puntero, no copia**: `→ estándares §3`, `→ decisiones.md 2026-05-04`,
  `→ CLAUDE.md`, `→ spec de pagos`. Ver abajo.

## Reglas aprendidas

Una regla aprendida **no vive en este índice, vive donde se aplica** — si no, se vuelve un
segundo lugar donde buscar la verdad y, con el tiempo, un log que nadie lee. El archive la
escribe en su destino natural y acá solo queda el puntero:

| Lo que se aprendió | Dónde se escribe |
|---|---|
| Convención técnica (nombres, patrones, manejo de errores…) | Los estándares base del proyecto (`F4.6`) |
| Decisión de proceso o de arquitectura | `decisiones.md` |
| Instrucción operativa para el asistente | `CLAUDE.md` |
| Comportamiento del producto | La spec de su capability |

**El default es `—`.** La mayoría de los changes no dejan regla. Se anota una solo si:

1. `verify` o `qa` corrigieron algo que **se repetiría** en el próximo change,
2. hubo que **decidir una convención sobre la marcha**, o
3. un **supuesto** del PRD (Product Requirements Document) o del spec **resultó falso**.

Sin ese umbral la columna se llena de ruido y el mecanismo se muere solo.