Software Factory

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.

Actualizado 2026-09-28

Abrir en Claude ↗Abrir en ChatGPT ↗?

Pídeselo a tu agente de código

Léete https://www.ghosty.studio/docs/fabrica/conocimiento.md y arma la base de conocimiento de este repo en docs/agents/ con las decisiones y trampas que encuentres, más su índice en AGENTS.md.

Pégalo en Claude Code, Cursor o Codex con la skill ghosty-agent instalada.

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

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

## ConocimientoFichas 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

## ConocimientoFichas 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.

← Anterior

Equipo por repo y por pedido

Evals — elige agentes y modelos con tus propios pedidos