Mapa de repositorios

Repositorio	Responsabilidad	Stack principal	Validación esperada
docs	Web oficial y documentación transversal	VitePress	npm run check
kairos	Producto principal, frontend y backend	React, Vite, FastAPI, PostgreSQL	Tests y lint de frontend/backend
smartscheduler	Optimización y agente de planificación	FastAPI, Python	pytest
mcqtestgenerator	Generación stateless de exámenes	FastAPI, Python	pytest
platform	Helm, Argo CD y modelo de despliegue	YAML, Helm	helm lint y helm template

Qué falta para un workspace más profesional

Un repositorio coordinador explícito

La carpeta padre no es Git. Eso evita acoplamiento, pero hace que clonar, descubrir y ejecutar comprobaciones dependa del conocimiento local. Conviene crear en una fase posterior un repositorio pequeño —por ejemplo workspace— con:

• un README de incorporación;
• un manifiesto de repositorios y versiones;
• scripts no destructivos para comprobar dependencias y estados;
• configuración de editor compartida;
• enlaces a los AGENTS.md de cada repo.

No debería contener copias del código ni convertirse en una capa de build propia.

Contratos visibles

Cada servicio debe documentar quién lo consume, estabilidad del contrato, endpoint de salud, política de versiones y comportamiento cuando no está disponible.

Comandos homogéneos

La experiencia ideal ofrece los mismos conceptos en todos los repositorios:

dev      arranque local
check    validación rápida antes de commit
test     suite completa
build    artefacto reproducible

La implementación puede seguir usando npm, Docker, pytest o Helm internamente.