📜 Reglas de Yggdrasil - El Árbol del Mundo
Versión: 4.0 Fecha: 2026-05-21 (Refactoring Fases 1-4) Aplicable a: Todo el ecosistema Yggdrasil
🌳 Principios Fundamentales
1. Un Proyecto, Un Reino
Cada proyecto reside en exactamente un reino en todo momento. No hay duplicados.
2. Flujo de Vida
Todo proyecto sigue el ciclo:
Idea → Muspelheim → [Reino Destino] → Helheim (si muere)
3. Límite de Proyectos Activos
- Muspelheim: Máximo 4 proyectos simultáneos
- Asgard: Paquetes modulares workspace (lilith-*, bifrost, vanaheim-framework)
- Jotunheim: Máximo 2 gigantes activos
- Cualquier otro reino: Sin límite estricto, pero mantener organizado
4. Legado Marcado, No Eliminado
Todo código legacy debe llevar un LEGACY.md o LEGACY_DIRS.md que explique qué lo reemplaza. La eliminación física a Helheim requiere migración git (commit de movimiento).
📋 Reglas por Reino
| Reino | Propósito | Paquetes/Proyectos Activos | Legado |
|---|---|---|---|
| Asgard | Tecnología core (Lilith modular) | lilith-core v2.0, lilith-memory v2.0, lilith-tools v2.0, lilith-orchestrator v2.0, lilith-api v2.2, lilith-cli v3.0, lilith-skills v1.0, lilith-bridge v1.0 | ⚠️ Lilith/ monolito v5.0 (LEGACY.md) |
| Alfheim | Prototipos UI | TerminalDashboard, dashboard (HTMX), YggdrasilForge, YggdrasilStudio | VSCode_Extension_Lilith |
| Midgard | Apps personales | Mínimo (10 .py) | — |
| Svartalfheim | Documentación, planes | Docs/, plans/ | — |
| Vanaheim | Agentes IA, framework | vanaheim-framework v1.0, bifrost v2.0, gamemaster-mcp-server v0.1 | ⚠️ Agents/, Core/, Config/, Bots_Lilith_v5/, Council/ (LEGACY_DIRS.md) |
| Jotunheim | Proyectos >1 mes | .gitkeep (vacío, aguarda) | — |
| Muspelheim | WIP, sprint mode | ForgeMaster v1.0.0 (238 tests), AutoSub v0.1, AI-Influencer (Fase 0) | ⚠️ kohya_ss eliminado (6.9 GB) |
| Niflheim | Assets, modelos, datasets | Modelos (4 GB), Datasets (341 MB) | gitignored |
| Helheim | Cementerio read-only | Graveyard.md, epitafios | Archivos legacy archivados |
🔄 Reglas de Migración
Cuándo Migrar
- A Helheim: Cuando un proyecto no ha sido tocado en 6 meses y no es dependencia de Asgard.
- A Midgard: Cuando un prototipo de Muspelheim es completamente usable para tareas personales diarias.
- A Jotunheim: Cuando un proyecto requiere gigabytes de datos o toma más de un mes en completarse.