Documentación Maestra — Timeliber Workspace (ACS v2026)
Fuente de Verdad Técnica. Este ecosistema de documentación sigue el estándar Agentic Collaboration Standard (ACS), optimizado para el trabajo fluido entre humanos e inteligencia artificial.
🗺️ Mapa de Navegación
1. Gobernanza y Protocolos (Capas Globales)
| Documento | Propósito |
|---|---|
| AGENTS.md | Manual de Vuelo Maestro. Estándares técnicos, protocolos de sesión y reglas de oro de ejecución. |
| CONTRIBUTING.md | Guía de colaboración Humano-IA. Cómo entrar y aportar al repo. |
| project.md | El "Alma" del proyecto. Filosofía, visión estratégica y roadmap de verticales. |
| mission.md | Misión activa y registro de hardening técnico. |
2. Hub Técnico (docs/)
| Componente | Documento |
|---|---|
| Arquitectura Global | 04_EXPLANATION/docs-architecture.md (Diagramas, topología documental y flujo entre workspaces) |
| Decisiones (ADRs) | 04_EXPLANATION/README.md (Registro vivo de decisiones y contexto transversal) |
| Referencia técnica | 03_REFERENCE/README.md (Contratos, índices y referencias consultivas) |
| Glosario | 04_EXPLANATION/glossary/GLOSSARY.md (Términos de dominio y arquitectura) |
| Inventario histórico | 04_EXPLANATION/archive/inventory/TECH_STACK.md (Evolución de dependencias) |
3. Detalle por Vertical (apps/)
Cada microservicio tiene su propia profundidad técnica:
- Timeliber Travel: ../apps/travel/README.md → Detalles en apps/travel/backend/docs/
- Gastro: ../apps/gastro/README.md → Detalles en apps/gastro/backend/docs/ y apps/gastro/frontend/*/docs/
- AI Orchestrator: ../apps/ai-orchestrator/README.md
- RAG Studio (Tools): ../apps/tools/rag/README.md
- Infra compartida: ../infra/README.md
🧼 Mantenimiento y Auditoría
Para asegurar que este cerebro digital se mantenga joven y preciso, DEBEMOS seguir el protocolo de autocuración:
1. Auditoría AX: Antes de cada commit, correr python scripts/audit_ax.py.
2. Sincronización: Si el código cambia, el diagrama Mermaid correspondiente en 04_EXPLANATION/docs-architecture.md DEBE cambiar.
3. Higiene: Documentos obsoletos deben ser movidos a 04_EXPLANATION/archive/.
Este índice es autodescubrible para agentes de IA. Úsalo como punto de partida para cualquier investigación.