ᛜ The Nine Realms
The Yggdrasil ecosystem organizes all projects into Nine Realms, inspired by Norse mythology. Each realm has a distinct purpose, color, and identity within the architecture.
Realm Map
| Realm | Alias | Purpose | Color |
|---|---|---|---|
| ᛊAsgard | asgard | Core technology, infrastructure, CLI | Cyan #38bdf8 |
| ᛉVanaheim | vanaheim | AI agents, bots, personality engines | Magenta #d946ef |
| ᚦAlfheim | alfheim | UI prototypes, web design, frontends | Aurora #7dd3fc |
| ᚨSvartalfheim | svartalfheim | Documentation, knowledge base, wikis | Gold #fbbf24 |
| ᛏMuspelheim | muspelheim | Active development, WIP projects | Red #ef4444 |
| ᛁNiflheim | niflheim | Resources, assets, media, datasets | Light Blue #93c5fd |
| ᚻHelheim | helheim | Archive, graveyard, deprecated projects | Purple #c026d3 |
| ᛃJotunheim | jotunheim | Massive projects, monorepos, enterprise | Orange #f97316 |
| ᛗMidgard | midgard | Personal apps, utilities, scripts | Green #22c55e |
Realm Details
ᛊ Asgard — Core Technology
The foundation realm. Houses the main infrastructure projects:
- Yggdrasil CLI — Command-line interface for the ecosystem
- REGLAS_YGGDRASIL.md — The global rules and conventions file
- Core libraries — Shared utilities and frameworks
asgard projects define the standards that all other realms follow.
ᛉ Vanaheim — AI Agents
Where the intelligence lives. AI-powered agents, bots, and personality systems:
- Lilith v2.0 — The flagship anime/cyberpunk neon personality engine
- Discord/Telegram bots — Agent interfaces for community interaction
- Prompt libraries — Character definitions, system prompts, response patterns
vanaheim projects are autonomous systems that perceive, reason, and act.
ᚦ Alfheim — UI Prototypes
The realm of visual creation. Frontend projects, design systems, and interfaces:
- BrierStudios Landing — The main website at brierstudios.com
- Docs site — This documentation hub at docs.brierstudios.com
- Design prototypes — Experimental UIs and visual concepts
alfheim projects prioritize aesthetics and user experience.
ᚨ Svartalfheim — Knowledge
The forge of documentation. Docs, wikis, and reference materials:
- Architecture docs — System design and decision records
- API references — Command catalogs and integration guides
- Tutorials — Step-by-step guides and onboarding materials
svartalfheim projects craft the knowledge that powers the ecosystem.
ᛏ Muspelheim — Active Dev
The crucible of creation. Work-in-progress projects and active development:
- Feature branches — Unreleased changes being actively developed
- Hot repos — Projects with daily commits and rapid iteration
- Staging environments — Pre-deployment testing grounds
Projects in muspelheim are not yet stable. They move to other realms upon release.
ᛁ Niflheim — Resources
The cold storage of assets. Datasets, media, and raw materials:
- Training datasets — LoRA reference images and captions
- Media assets — Icons, SVGs, fonts, textures
- Configuration files — Shared configs pushed across projects
niflheim projects are rarely modified but frequently referenced.
ᚻ Helheim — Archive
The graveyard. Deprecated, abandoned, or completed projects:
- Legacy repos — Old versions kept for reference
- Deprecated tools — Replaced by better solutions
- Completed experiments — One-off projects that served their purpose
Projects in helheim are no longer active but preserved for history.
ᛃ Jotunheim — Massive Projects
The realm of giants. Large-scale monorepos and enterprise projects:
- Ecosystem consolidations — Multi-package monorepos
- Enterprise systems — Large, multi-team projects
- Platform services — Shared infrastructure at scale
jotunheim projects are characterized by their scope and complexity.
ᛗ Midgard — Personal Apps
The human realm. Personal utilities, scripts, and daily tools:
- Automation scripts — Personal workflow automation
- Utility apps — Small tools for daily use
- Config dotfiles — Personal development environment setup
midgard projects are practical, personal, and pragmatic.
CLI Realm Aliases
Each realm has a short alias for the Yggdrasil CLI:
# List all projects in a realm
ygg asgard list
ygg vanaheim list
ygg alfheim list
# Create a new project in a realm
ygg muspelheim create my-project
# Move a project between realms
ygg niflheim move my-asset muspelheim