π Yggdrasil Rules - The World Tree
Version: 4.0 Date: 2026-05-21 (Fases 1-4 Refactoring) Applies to: The entire Yggdrasil ecosystem
π³ Fundamental Principlesβ
1. One Project, One Realmβ
Every project resides in exactly one realm at all times. No duplicates.
2. Lifecycle Flowβ
Every project follows the cycle:
Idea β Muspelheim β [Target Realm] β Helheim (if it dies)
3. Active Projects Limitβ
- Muspelheim: Maximum 4 simultaneous projects
- Asgard: Modular workspace packages (lilith-*, bifrost, vanaheim-framework)
- Jotunheim: Maximum 2 active giants
- Any other realm: No strict limit, but keep organized
4. Legacy Marked, Not Deletedβ
All legacy code must carry a LEGACY.md or LEGACY_DIRS.md that explains what replaces it. Physical deletion to Helheim requires git migration (move commit).
π Rules by Realmβ
| Realm | Purpose | Active Packages/Projects | Legacy |
|---|---|---|---|
| Asgard | Core technology (Modular Lilith) | 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/ monolith v5.0 (LEGACY.md) |
| Alfheim | UI Prototypes | TerminalDashboard, dashboard (HTMX), YggdrasilForge, YggdrasilStudio | VSCode_Extension_Lilith |
| Midgard | Personal apps | Minimum (10 .py) | β |
| Svartalfheim | Documentation, plans | Docs/, plans/ | β |
| Vanaheim | AI Agents, framework | vanaheim-framework v1.0, bifrost v2.0, gamemaster-mcp-server v0.1 | β οΈ Agents/, Core/, Config/, Bots_Lilith_v5/, Council/ (LEGACY_DIRS.md) |
| Jotunheim | Projects >1 month | .gitkeep (empty, waiting) | β |
| Muspelheim | WIP, sprint mode | ForgeMaster v1.0.0 (238 tests), AutoSub v0.1, AI-Influencer (Phase 0) | β οΈ kohya_ss deleted (6.9 GB) |
| Niflheim | Assets, models, datasets | Models (4 GB), Datasets (341 MB) | gitignored |
| Helheim | Read-only graveyard | Graveyard.md, epitaphs | Archived legacy files |
π Migration Rulesβ
When to Migrateβ
- To Helheim: When a project has not been touched in 6 months and is not a dependency of Asgard.
- To Midgard: When a Muspelheim prototype is fully usable for daily personal tasks.
- To Jotunheim: When a project requires gigabytes of data or takes more than a month to complete.