Saltar a contenido

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_REFERENCE gana sobre documentos narrativos.
  • El código gana sobre cualquier documento narrativo si hay contradicción.
  • README.md del workspace es puerta de entrada, no contrato ni inventario exhaustivo.
  • AGENTS.md del workspace es routing + reglas, no estado factual largo.
  • .agent/context/project.md es contexto estratégico, no autoridad técnica exacta.