Este repositorio se usa como base canónica de conocimiento para agentes con contexto del repo y para documentar trabajo real.
Hoy la ruta activa del repo es:
base/masters/como fuente canónica operativa,base/json/como capa estructurada derivada,docs/como definición y decisiones,projects/como capa de casos reales y trazabilidad de proyectos,tools/como utilidades locales para operación e ingesta por agentes,app/web/como consumidor actual de esa base,archive/como preservación de material fuera del camino activo.
| Punto | Ubicación | Uso |
|---|---|---|
| Changelog | CHANGELOG.md |
Revisar cambios estructurales del workspace |
| Inicio rápido de la base | base/masters/company/00-INICIO-RAPIDO.md |
Entrar a la librería operativa |
| Visión y decisiones | docs/VISION-APP.md |
Entender contexto, producto y dirección |
| Arquitectura funcional | docs/ARQUITECTURA-FUNCIONAL.md |
Revisar contratos y capas |
| Casos reales | projects/README.md |
Navegar trabajos reales documentados |
La fuente de verdad del workspace es:
base/masters/base/json/docs/projects/
app/web debe entenderse como consumidor o superficie de implementación, no como fuente de verdad.
El uso operativo recomendado del workspace es con agentes que lean el repo y usen esta librería como backend de conocimiento.
Fuera de base, docs, projects y el consumidor actual app/web, el resto de superficies debe considerarse:
- experimental
- auxiliar
- o candidata a deprecación si no está en uso real
El CLI standalone fue retirado de la ruta activa.
base/
masters/ fuente canónica humana y operativa
json/ datos estructurados generados
app/
scripts/ utilidades auxiliares para derivar estructura
web/ consumidor actual de la base, no fuente de verdad
tools/
ingest/ utilidades locales para leer archivos operativos desde projects/
docs/
visión, arquitectura, decisiones y roadmap
projects/
proyectos reales documentados con rastro operativo
archive/
material preservado fuera del camino activo
- Cambios de conocimiento y taxonomía van primero en
base/masters/. - Se regeneran estructuras con
python3 app/scripts/build_json.py. - Si se necesita una salida derivada de navegación, se puede regenerar con
python3 app/scripts/build_indices.py. - Cualquier implementación debe seguir lo definido en
docs/y consumir la base canónica sin reemplazarla. - Los casos reales o pilotos que ya tienen brief y entregables deben normalizarse en
projects/, no quedarse como archivos sueltos enarchive/projects/.
Para mantener el repo liviano en contexto para agentes:
- mantener solo capas activas o claramente canónicas
- retirar o deprecar pruebas que no estén conectadas al camino real
- evitar multiplicar superficies paralelas si
app/webes la única desarrollada a profundidad projects/se mantiene como capa de casos reales y trazabilidad de trabajos ejecutados