CLAUDE.md

# CLAUDE.md

> Documento vivo. Se actualiza al completar cada paso del workflow, en cada fase archive, y
> cuando un agente detecta información obsoleta o faltante. **Se reemplaza, no se anexa**: es un
> snapshot del presente, no un registro. Si una información ya no afecta las decisiones de la fase
> actual, sale de aquí; **si una línea empieza con una fecha, no va acá** — va a `decisiones.md`,
> al índice de changes archivados, a `auditorias/` o al CHANGELOG del producto.
> **Tope: [200] líneas** (chequeado en CI —Continuous Integration—); al pasarlo, se poda antes de seguir.
> La metodología NO vive en este archivo — se sigue desde su documentación: [ruta/URL a Argui].

## Proyecto

[Una frase: qué es y para quién]

## Fase actual

**Paso F[fase].[paso] de Argui**: [nombre del paso]

[Qué se está haciendo en este momento y qué falta para pasar al siguiente paso]

## Directivas operativas

> Reglas que todos los agentes obedecen siempre, en cualquier fase.

- Los agentes no ejecutan git: proponen ramas, commits (Conventional Commits) y PRs (Pull Requests); el humano confirma y ejecuta. Cadencia y disciplina en `operations.md` de Argui
- Idioma de los artefactos: **[idioma]** (PRDs —Product Requirements Document—, prosa de agentes, commits, código, UI —interfaz de usuario—) — decisión del proyecto, independiente del idioma de la metodología
- Versión de Argui: **[vX.Y]** — contra qué versión de la metodología se construyó/actualizó el proyecto
- Versión de OpenSpec: **[vX.Y.Z]** — la fijada en `F0.2`, contra la que el schema `argui` está forkeado y validado; se actualiza al re-validar el ciclo, no al instalar
- El proyecto **no usa la memoria del asistente** (el almacén propio de la herramienta, fuera del repositorio): los hechos del proyecto van a los archivos, y lo que sería una memoria va a *Notas operativas*, acá abajo. Las preferencias personales de cada dev quedan fuera de esta regla
- [Otras directivas del proyecto — ej. no instalar dependencias sin aprobación, no tocar producción]

## Stack y decisiones clave

- **Stack**: [lenguajes, frameworks, base de datos, infra]
- [Decisión arquitectónica relevante 1 — con enlace a su justificación]
- [Decisión arquitectónica relevante 2]

## Mapa del proyecto

| Qué | Dónde |
|---|---|
| Referencias iniciales | `initial-references/` (en `.gitignore` — confidencial) |
| Documento de Entendimiento | [ruta] |
| PRD inicial (fases 2–3; se parte en dos en F3.4) | [ruta] |
| PRD de negocio | [ruta] |
| PRD técnico | [ruta] |
| Prototipo | [ruta del archivo único; URL si está publicado] |
| Inventario de flujos (si se refinó, F3.5) | [ruta] |
| Backlog | [ruta] |
| Estándares | [ruta] |
| Registro de decisiones | `decisiones.md` |
| Auditorías periódicas | `auditorias/` (un archivo por auditoría + índice) |
| Índice de changes archivados | [ruta de la carpeta de archivo de OpenSpec]`/README.md` |
| Agentes | `.claude/agents/` |
| Design system | [ruta] |

## Reglas de la fase actual

- [Qué se puede hacer en este momento del proceso]
- [Qué NO se puede hacer todavía]

## Estado del backlog

- **Completado**: [ítems]
- **En curso**: [ítem actual y su fase OpenSpec: apply / verify / qa / archive]
- **Siguiente**: [próximo ítem]

## Notas operativas

[Solo lo que un agente necesita saber hoy para no equivocarse. Máximo 5 puntos. Es el destino de
lo que en otro proyecto sería una memoria del asistente: se versiona, se revisa y se poda.
Ejemplo del tipo de nota que va acá:]

- La metodología vive en `[ruta fuera del repositorio]`: se consulta con la herramienta de
  lectura, no con comandos (`cat`/`grep` fallan ahí como si la ruta no existiera)