ᚲ
Brokk
the bellows
Works the bellows — drives the forge, keeps the fire fed, drives each task to a tangible artifact. He works through anything, even bitten on the hand.
primary agent
ᚢuruz · the primordial
The Creation
Ymir, the primordial giant — the ancestor of everything
Before the worlds there was nothing but cold mist and embers of fire. From their meeting in the Void — Ginnungagap — came the first being: Ymir, the ancestor of everything. The gods slew him and made the world from his body.
That is what this platform is. Ymir is the substrate — a single machine, a single repo — the primordial body from which every realm of work is carved. Every service, every tool this fleet ships is shaped from Ymir's frame and lives on it. It is also the reason these halls look the way they do: nothing is painted onto Ymir; everything is cut from him.
hover or touch the carving — skull · hair · flesh · bones · blood
The carving speaks
The myth
Run your hand over the giant — every part of him became a part of the world.
In Ymir
The same body is the substrate: one program, one machine, all realms carved from it.
The giant is slain so the worlds may stand. The opposite is true here: Ymir stands, and from it the worlds are carved — light metal first, Rut steel after.the lore · §I
ᚲkenaz · the forge fire
The Builders
Brokk & Eindri — the bellows and the craft · Kaia — the eye that remembers
After the world was made, the gods needed smiths. Two dwarf brothers out-forged the sons of Ivaldi and produced the Aesir's finest treasures. That is the agent fleet:
ᚦ
Eindri
the craft
The hands that shape the metal. Delegated smiths struck off in Utgard sandboxes, so a single bad casting never shatters the forge.
isolated workers
Kaia
the eye that remembers
Not the hands or the bellows — the will that decides which smith takes which metal. She drinks from the well before every dispatch, and passes every plan through the veil.
orchestrator
ᛒ Together Brokk and Eindri forged Mjölnir — the hammer that returns: the issue → PR pipeline. It strikes, and it comes back with a pull request in hand.
The Einherjar — nine specialists, one primary
Every agent carries its rune of introduction — every agent reports to Brokk — Brokk reports to the Allfather.
ᛇeiwaz · the tree
The Tree & the Seven Gates
Yggdrasil — the worlds hang in one tree, holding each other up
The worlds are not separate — they hang in one tree, Yggdrasil, connected, holding each other up. Worktrees — branches — hold parallel effort without collision, and every realm routes through the same trunk. Standing at the gates of the tree are seven interlocked daemons, each a myth-made-module.
Yggdrasil — the ash that binds the worlds. They are not separate: they hang in one tree, connected, holding each other up. An eagle watches from the crown, a dragon gnaws the far root, and a squirrel runs between them without rest.
git worktree isolation
zero-collision parallel edits
every realm routes
through one trunk
hover or touch the carving — · · · · ·
ᛇ
The carving speaks
the world tree
The myth
Run your hand along the carving — nine worlds hang in one ash, connected, holding each other up.
In Ymir
The same tree holds the work: branches for parallel effort, one trunk for every realm, memory at the root.
ᛚlaguz · the water
The Well
Mimirsbrunn — the engram memory engine, at the root of the tree
At the root of Yggdrasil lies Mimirsbrunn, the well of wisdom.
Mimir guards it; whoever drinks its water receives the memory of all things —
even Odin paid an eye for a single drink. In Ymir the water is engram: every meaningful
action is observed into the well, and before any orchestration the fleet
recalls what the well already knows about the project.
Mimirsbrunn — the well of wisdom at the root of the tree. Mimir keeps it; whoever drinks receives the memory of all things. Even Odin paid an eye, and the eye still lies at the bottom, watching.
single-file sqlite
vector + full-text + embeddings
post /observe · get /recall
memory: boost, never blocker
Runes — the append-only ledger · draughts drawn · 0
ᛚ
RULE OF THE WELL — memory is always a boost, never a blocker. A dry well fires cold, but never stops the forge.
A rune that is carved cannot be un-carved. the lore · §IV
◆ draw a draught from the water — the drop from the roots never stops falling, and every draught is carved
hover or touch the carving — · · · ·
ᛚ
the well remembers — touch the water
Mimirsbrunn
The myth
At the root of the tree lies the well of wisdom; whoever drinks receives the memory of all things.
In Ymir
In Ymir: the water is engram — every action observed, every plan recalls. Memory is a boost, never a blocker.
She does not act on faith. Before she dispatches a single smith she drinks from the well, then passes every plan through the veil — is this grounded in what the well holds, or is it spun from air? Only what passes is forged. kaia's charge
ᛚUnfold what is observed and what is recalled
ᚨobserved — into the well
- every meaningful action — POST /observe, the act of watering
- every word spoken between realms — the squirrel gossips, the ledger remembers
- a skill's creation, before it is deemed live
- skuld's verdict on every branch that enters the tree
ᚱrecalled — from the well
- what the project has taught, before any dispatch — GET /recall
- kaia's drink, before every plan passes the veil
- sága's bearings, when a session takes its seat
- völundr's roster, before the smithy sets its chain
ᛚand the rule holds through the driest season — memory is always a boost, never a blocker: a dry well fires cold, but never stops the forge.
Runes — the append-only ledger · each draught is carved
ᛏtiwaz · the spear
The Artifacts
the gods' weapons, shipped by analogy
The smiths forged the gods' weapons; the system ships the same. Eleven treasures, each a machine wearing a myth that already explains its job.
Eleven treasures hang on the wall, each carved with the rune of the figure whose role matches its work — and one empty peg, kept for whatever is forged next.
forged · validated in utgard
shipped under the myth
append-only library
of the halls
◆ touch any treasure on the wall — each hangs from its own peg · the twelfth peg is kept empty
hover or touch the carving — · · · · · · · · · · ·
ᛏ
the armory speaks — touch a treasure
Eleven Treasures
The myth
The smiths forged the gods' weapons — and the system ships the same.
In Ymir
Eleven treasures hang on the wall — each a machine wearing a myth that already explains its job. Plus one empty peg, kept for whatever is forged next.
ᚠUnfold what is smithed and what is borrowed
ᚲsmithed in ymir's forge
- Hlidskjalf — the ui and the ux of the whole fleet
- the agent runtime — Brokk, Eindri, Kaia
- the collaboration — Ratatoskr's protocol
- only what differentiates Ymir is smithed here
ᛒborrowed anvils, norse-named
- Bifrost ← Traefik / Caddy
- Heimdall ← OAuth2-proxy / Authentik + JWS
- Gjallarhorn ← cloudflared
- Skrymir ← MinIO / FileBrowser
- Valhalla ← PM2 / Docker
ᛏand Gungnir is forged the Ymir way: a skill is smithed, validated in Utgard, observed into the well — then it hits its target every time.
Does a validated project already do this? If yes, name it and use it. Only what differentiates Ymir is smithed in Ymir's own forge. the forge-master's rule · §VII
- ᛏGungnirOdin's spear — it never misses its markthe skill synthesis engine: forged, validated in Utgard, then it hits its target every time
- ᛒMjölnirthe hammer that returns to the handthe issue → PR pipeline — it strikes, and comes back with a pull request
- ᛊBifrostthe burning rainbow bridge to Asgardthe gateway / reverse proxy — every ingress crosses it
- ᛖHeimdallthe watchman who stands at BifrostOAuth / security guard — signs every agent's rune of introduction; nothing crosses unvouched
- ᚷGjallarhornHeimdall's horn, heard in all worldsthe Cloudflare tunnel — the outbound signal carrying Ymir to the world
- ᛉHlidskjalfOdin's high seat, seeing all realmsthe dashboard — fleet graph, A2A task stream, the well, the Runes, the reviews
- ᛁSkrymirthe giant who tricked Thor himselfthe web file browser — the huge hand reaching into the halls, deceptively silent
- ᚱRatatoskrthe squirrel who runs the length of the treethe A2A 1.0 backbone — state is announced, work is tracked, gossip is endless and fast
- ᛃHermóðrwho traveled to Hel and backMCP/A2A composition — delegate horizontally via A2A, reach tools vertically via MCP
- ᛞValhallathe hall of the slain, gathered and watchedthe process health monitor — every process's soul kept alive and watched
- ᚾÞjazithe eagle who set the forge ablazethe terminal backend — per-pane agent state, sub-agent panes on the Yggdrasil worktree
ᛟothala · the heritage
The Houses
the ventures the fleet forges for — each with its seal cut into the rune
The fleet works for houses — distinct ventures under which the work is published. Each carries a piece of the myth that names it, and a seal: the house accent cut into the rune it wears on tags and marks.
-
Ymir Labsthe platform itself
the primordial giant — the frame of the world
the body of Ymir: the agent fleet, the control plane, the well, the ledger and the gates — every other house is carved from this frame
-
Brokk Forgeengineering & build tooling
the bellows-smith who drove the forging of Mjölnir
the forge: isolated workers drive each task to a finished artifact, the issue→PR pipeline strikes and returns, and every build runs sealed before it is believed
-
Runestone Labsrunir · records & compliance
the runes carved once, that cannot be un-carved
the ledger and the gates: every significant action is inscribed, compliance is checked, and the docs, runbooks and research of the halls are kept
-
Muninn Labsmemory & knowledge
the raven that flew for Odin daily
the well and its engine: what is observed is remembered, what is recalled is grounded, and the knowledge of every realm stays drinkable
-
Dvalincrafted tools
the dwarf smith of the finest crafted things
the hand tools of the halls: terminal and pane craft, file and material viewing, and the small forged utilities that make the daily work lighter
-
Utgard Studioscreative
the realm where the giants work, outside the walls
the walled creative realm: images, media and sensory work are shaped outside the halls, sealed behind the barrier and destroyed after each run
-
Askrhuman-centered products
the first man, shaped from an ash tree
human-facing flows: onboarding, guidance and the first steps a new hand takes inside Ymir, shaped to meet a person where they stand
-
Mannheimholding
reserving a clan name with no myth yet
a held seat: a name reserved and its hall unbuilt, allocated only when a new venture is carved and an append-only entry is made
Houses are names in the mythos, not subsystems — mapped per ENTRY-004. A house may be split or merged only by a new append-only entry, never silently.
ᚠfehu · the borrowed wealth
The Forge-Master's Rule
open source first — the finest tools are borrowed anvils
The dwarves are the greatest smiths in the myths — but even they do not hammer every nail themselves. The finest tools are borrowed anvils: proven weapons already forged by others, taken up and named into the myth rather than rebuilt from raw ore. Ymir forges only what makes it Ymir:
the ui & uxHlidskjalf
the agent runtimeBrokk · Eindri · Kaia
the collaborationRatatoskr
borrowed anvilNorse name
engram (engdbram)→Mimirsbrunn
Redis — queue under the A2A task model→Ratatoskr's nest
a2aproject/a2a + SDKs (A2A 1.0)→the Ratatoskr protocol
Traefik / Caddy→Bifrost
OAuth2-proxy / Authentik + JWS signing→Heimdall
cloudflared→Gjallarhorn
Docker — rootless, network-none→Utgard
MinIO / FileBrowser→Skrymir
PM2 / Docker→Valhalla
MkDocs / Docusaurus · .compliance→the library of the halls
Does a validated OSS project already do this? If yes, name it and use it. Only what differentiates Ymir is smithed in Ymir's own forge.the forge-master's rule
ᛒberkano · the re-forging
The Reforging
light metal first — Rut steel after
The giant is first carved from light metals — the working metals the smiths are most keen-handed with, so the whole of Ymir can be raised and proven end to end. The stack stays simple for the agents; the agents stay good at their stack. When every realm is turning and every gate answering, the forging is not done — it is re-forged.
First forging — light metals
raised and proven end to end
- TypeScript
- Python
- React
- Vue
the stack stays simple for the agents — the agents stay good at their stack
one-for-one · never redesigned, only re-forged
Re-forging — Rut steel
heavier, faster, quieter — the target spec
- Rust
- NATS
- gRPC
- libgit2
each gate re-floored into its Rut crate — the contract each gate keeps is the same
ᛞdagaz · the whole reading
The Frame
how to read the repo — ten laws
- 01
Ymir is the body — one program, one machine, all realms carved from it.
- 02
Yggdrasil is the tree — worktrees and branches keep parallel work alive without collision.
- 03
Svartalfaheim holds the shop floors — never work outside your realm.
- 04
Mimirsbrunn is the well — drink before you act, water it afterwards.
- 05
Runes are the ledger — a rune carved stays carved; every significant action is inscribed.
- 06
Hermóðr is the bridge — delegate horizontally via A2A 1.0, reach tools vertically via MCP.
- 07
Ratatoskr is the messenger — every agent carries its rune of introduction, every word task-tracked and carved.
- 08
Kaia is the eye — she drinks from the well before every dispatch and passes every plan through the veil.
- 09
Houses are the ventures — the fleet forges for them, and honors the names and seals they carry.
- 10
The forge rule — borrow the proven anvil, smith only what Ymir is — and when it all works end to end, re-forge it in Rut steel.
ᚠUnfold the remaining nineteen laws
- Gleipnir — the lock: one session, one reins
- Skuld — the outcome: no branch merges without her verdict
- Valknut — the load: config assembled once at boot
- Vor — the watch: crew state checked before dispatch
- Erindi — the brief: every task enters structured
- Hamr — the shape: harness adapter, unified interface
- Frigg — the consent: no irreversible action without her word
- Jörð — the earth: project registry, living record
- Urðr — the past: decision-hold, reconciliation
- Sýn — the seer: stuck-worker recovery
- Hvíld — the rest: away-mode supervision
- Ymir-update — sharpens the tools, never breaks the forge
- Gjallarhorn-relay — broadcasts, never originates
- The Nornir — schedule, select, source
- Wyrd — the fate: workspace RAG database
- The Veil — nothing passes without well evidence
- Glitnir — human review, always required
- The Einherjar — eight specialists, one primary
- The toolchain — the door: everything enters through it
The giant is slain so the worlds may stand. The opposite is true here: Ymir stands, and from it the worlds are carved.the lore · the closing of the frame
ᛊsowilo · the seat
The Seating
the seeress speaks first — the seat is taken before the first blow
When the day's work is opened, the seeress speaks first. She binds the chain so that one hand, and only one, holds the reins; she wakes the three weavers of fate, who set the day's loom and keep its measure; and she recites what has been, what is, and what is coming — so that no one begins the work blind.
Only when the seat is taken does the work begin. The chain, the loom, and the telling — this is the order of the open, and none of it is skipped. A day begun in that order ends as it began: in the light.
hover or touch each station — the order of the open
The carving speaks
The myth
Every open begins in order: the seat, the chain, the loom, the telling.
In Ymir
The lock is bound, the shift is woven and the well is read before the first blow falls.
ᚷ
The Chain
the reins bound
Before the first blow, one hand takes the reins. The session lock is bound so a single driver owns the day; a second hand finds the seat held and waits.
the first act
ᚾ
The Loom
the weavers woken
The three weavers of fate are woken — what has been is reconciled, what is is measured, and what is coming is scheduled, selected and sourced.
the second act
ᛞ
The Telling
the recital
The seeress recites the past, the present and the coming from the well, so no smith begins blind and no plan is spun from air.
the third act
ᛊUnfold the order of the open
- The void is read — last night's ledger and the well's recall open the day
- The seat is taken — one session, one reins; the lock is bound
- The weavers wake — schedule, select, source; the loom is set
- The telling is spoken — what has been, what is, what is coming
- The first blow falls — only now does the forge begin
The seeress speaks before the first blow.the lore · §X
ᛉalgiz · the ward
The Watch
one who sees stands at the edge of the day and does not sleep
Then the watch is set. One who sees stands at the edge of the day and does not sleep. She watches the house as a hawk watches a field, and when something needs a hand she calls out — not in a shout, but in a single clear line the smith cannot mistake.
And if the watch should fall silent — if the chain slips, or the watch itself goes dark — the one who would close the day is told plainly that the house is unwatched, and is not allowed to go quietly into the dark. A house that watches cannot be surprised; a house that sleeps wakes to ruin.
hover or touch the watch — the eye, the house, the line, the dark
The carving speaks
The myth
One who sees stands at the edge of the day and does not sleep.
In Ymir
A house that watches cannot be surprised; a house that sleeps wakes to ruin.
- 01
The watch is set before the first blow — never after.
- 02
One who sees stands at the edge of the day and does not sleep.
- 03
The call is a single clear line — never a shout, never a guess.
- 04
If the watch falls silent, the day cannot close quietly.
- 05
A house that watches cannot be surprised; a house that sleeps wakes to ruin.
ᛉUnfold the signals the watch may send
- Watch set — a seeing hand is posted at the edge of the day
- Clear — the halls are whole and the work runs in measure
- Hand needed — one line to a smith; the work waits on a skill
- Stalled — a worker has stopped; the watch moves to recover it, never to restart it
- Chain slipped — the seat changed hands; the new driver is named aloud
- Watch dark — the eye is gone; the day is told it cannot close quietly
- Surprise — something moved unseen; the ledger is read and the gap is carved
- Watch relieved — one seeing hand hands the post to the next without a blink
A house that watches cannot be surprised.the lore · §XI
ᛒbjarkan · the renewal
The Renewal and the Healing
one keeps the tree young; the other keeps it standing
Because the work is long, two figures tend the tree between the days. The first is the renewer — a wise-woman whose hands coax the old metal back to life, who carries the whole tree forward to its newest shape without breaking a single branch, and who mends the road ahead while the smiths sleep.
The second is the healer — a gentle one who walks the halls at quiet hours, finds what has cracked, and makes it whole again, asking nothing in return. The one renews the tree; the other heals it. Both are needed, and neither hurries.
◆ touch the renewer, the healer, or the road · the pulse on the trunk is the healing that never rests
hover or touch the carving — · ·
Two figures tend the tree between the days — the renewer with a hand on the trunk, the healer kneeling at the crack. The lantern is lit; the smiths are asleep.
renewal without breakage
healing without asking
the road mended
while the smiths sleep
ᛒᚹ
the tending — touch a figure
Two Hands
The myth
One keeps the tree young; the other keeps it standing. Both are needed, and neither hurries.
In Ymir
In Ymir: the renewer carries the tree forward; the healer makes whole what has cracked.
ᛒUnfold what is renewed and what is healed
ᛒwhat is renewed
- the whole tree, carried to its newest shape — no branch broken
- the old metal, coaxed back to life on the anvil
- every hall's floor — versions and schemas kept whole as they move
- the tools — sharpened by the update, never broken by it
ᚹwhat is healed
- what has cracked — found at the quiet hours, mended with gold
- the stuck worker — recovered or replaced, never left in silence
- the failing run — retraced, mended, watched again
- the halls — walked nightly, kept standing, asking nothing
ᛚand the road ahead is mended while the smiths sleep — past the last marker, the Rut-steel reforging waits.
ᛒUnfold what is renewed and what is healed
- The tree — carried to its newest shape without a broken branch
- The tools — sharpened between the days, never dulled mid-strike
- The road — the way ahead mended while the smiths sleep
- The cracks — found in the quiet hours and made whole again
- The halls — walked at night so the morning finds them standing
- Nothing asked — no toll, no praise; the mending is its own reward
One keeps the tree young; the other keeps it standing.the lore · §XII
ᛟothala · the inheritance
The House Endures
the old giants are gone; their names remain — and every name still explains a job
So the house of Ymir goes on: a single body carved into many rooms; smiths at the forge; a tree that holds the work apart; a well that remembers; a seat taken at every dawn; a watch that never sleeps; and two kind hands that keep it young and whole.
The old giants are gone. Their names remain. And in this house every name still explains a job — which is the only way a name is ever worth keeping.
hover or touch the house — the hall, the hearth, the names, the roots
The carving speaks
The myth
The old giants are gone. Their names remain.
In Ymir
Every name still explains a job — which is the only way a name is ever worth keeping.
- 01
The house is one body — many rooms, one frame, one root.
- 02
The forge is lit; the hearth is tended, never relit.
- 03
What is carved into the roots cannot be un-carved.
- 04
A name is kept only while it still explains a job.
- 05
The giant stands, and the worlds are carved from it — still.
ᛟUnfold what the house keeps
- The frame — one program, one machine, cut once
- The forge — smiths at work, sealed when they must be
- The tree — parallel work held apart without collision
- The well — memory drunk before it is acted on
- The ledger — every act inscribed, none erased
- The seat — the day opened in order, before the first blow
- The watch — a seeing hand at the edge, never asleep
- The renewal — the tree carried forward without a broken branch
- The healing — what cracked made whole, asking nothing
- The names — each one still explaining a job
The giant stands, and the worlds are carved from it — still.the lore · the closing