Fuentes de Verdad — Gastro
Este documento define qué artefacto manda según el tipo de pregunta. Si dos documentos se contradicen, gana la fuente más específica de esta tabla.
| Pregunta | Fuente canónica | Secundarias | No usar como autoridad |
|---|---|---|---|
| Qué endpoints existen | backend/docs/03_REFERENCE/openapi.json |
endpoints.md, backend/app/api/v1/router.py |
tutoriales, changelog |
| Cómo se comporta un endpoint | backend/docs/03_REFERENCE/endpoints.md |
código de router/service/repository | README del workspace |
| Variables y defaults backend | backend/docs/03_REFERENCE/environment.md |
app/core/config.py |
docs narrativas |
| Qué dominios backend están activos | backend/MAP.md + código |
backend/AGENTS.md |
.agent/context/project.md |
| Estado real de módulos de producto | current-state.md |
TECH_DEBT.md |
README.md, tutoriales |
| Integraciones activas vs futuras | current-state.md + DEPENDENCIES.md |
TECH_DEBT.md |
roadmap repetido en varios archivos |
| Topología de frontends | frontend/docker-compose.yml |
frontend/AGENTS.md |
afirmaciones históricas en changelog |
| Deuda viva | TECH_DEBT.md |
auditorías vigentes | changelog |
| Historia de cambios | CHANGELOG.md |
commits | TECH_DEBT.md |
| Contexto estratégico | .agent/context/project.md y mission.md |
README.md |
03_REFERENCE |
Reglas operativas
03_REFERENCEgana sobre documentos narrativos.- El código gana sobre cualquier documento narrativo si hay contradicción.
README.mddel workspace es puerta de entrada, no contrato ni inventario exhaustivo.AGENTS.mddel workspace es routing + reglas, no estado factual largo..agent/context/project.mdes contexto estratégico, no autoridad técnica exacta.