# Base de conocimiento del repo

> Lo que los agentes deben saber de tu proyecto vive en tu repo — fichas en `docs/agents/` con `AGENTS.md` como índice — y la Software Factory la lee y la mantiene por PR.

URL: https://www.ghosty.studio/docs/fabrica/conocimiento

Las decisiones, trampas y el vocabulario que el código no dice solo viven **en tu propio repo**, no en Ghosty:

- **Versionada** y revisada por PR, como cualquier código.
- La lee **cualquier agente**: Claude Code, Codex, Cursor o goose leen `AGENTS.md` solos.
- Sin índice externo que se desactualice.

## El formato

```text
AGENTS.md              ← índice: comandos, arquitectura, convenciones y la sección «Conocimiento»
docs/agents/
  pagos.md             ← una ficha por tema
  zonas-horarias.md
  glosario.md
```

Cada ficha es corta: **qué** es, **por qué** se decidió así y **cómo** aplicarlo. En `AGENTS.md`, un renglón por ficha:

```markdown
## Conocimiento
Fichas cortas en `docs/agents/`: decisiones, trampas y glosario que el código no dice solo.

- [Pagos](docs/agents/pagos.md) — los montos van en centavos; Stripe es la fuente de verdad
- [Zonas horarias](docs/agents/zonas-horarias.md) — todo se guarda en UTC y se pinta en CDMX
```

«Preparar repo» ya deja la sección «Conocimiento» en el `AGENTS.md` que escribe.

## Cómo la usa la fábrica

| Rol | Qué hace con la base |
|---|---|
| `@plan` | Recibe la lista de fichas en cada turno, lee las del tema y cita en el plan las que usó. Si el pedido fija una decisión que no está escrita, pone en el plan «Ficha: `docs/agents/<tema>.md`». |
| `@build` | Si el plan pide una ficha, si su cambio fija una convención o si descubre una trampa, escribe o actualiza la ficha **en el mismo PR** y su renglón en `AGENTS.md`. |
| `@check` | Si el PR contradice una ficha, o falta la que pedía el plan, es un hallazgo. |

Así la base crece con cada pedido y cada cambio a ella pasa por tu revisión.