2026-10-11 16:59:00 +02:00
2026-10-11 16:56:32 +02:00
2026-10-11 16:56:32 +02:00

Ouroboric

Ouroboric (ouroboric.dev) builds open factories that improve themselves: for software, companies, and in time research and art. This repository is the company umbrella. Start with the charter.

The map

Ouroboric map: the founder approves direction in the Asgard realm (readiness checklist, Ginnungagap kickstart graph); Yggdrasil, the agentic factory, contains Odin, Jormungandr, Gleipnir, Havamal, the realms (Midgard and Helheim in v0, Jotunheim and Muspelheim later) and the Asgard realm, all honouring the Gungnir contract, with Ratatoskr, Norns, Mimir and Bragi later; the Asgard realm kickstarts and the other realms build companies and products, whose lessons and benchmarks feed back into Ouroboric

The names come from Norse myth; the naming and mythology record tells the story behind each one, and its long-term map shows what comes after v0.

Contents

Folder What's there
1-company/ charter, roadmap, legal, readiness
4-ways-of-working/ the standards every Ouroboric product follows: spec-driven development, docs, writing styles, diagrams
5-research/ company-level research
6-journal/ the journey: challenges, solutions, results
7-branding/ the Ouroboric story, identity, voice, prompts

Repositories in the ouroboric-dev organisation:

Repository Visibility Role
.github public organisation profile and defaults (health files, issue forms, PR template); every change is organisation-wide
ouroboric public this company umbrella
yggdrasil public the product: the agentic factory
asgard public the Asgard realm; a product umbrella until it becomes a leaf of yggdrasil after Yggdrasil v0

Each operator also keeps a private instance umbrella (L0), outside this repository, with pinned factory versions, their own projects, hidden benchmarks and private notes. It never lives here.

Products, as submodules under products/ (clone with --recurse-submodules):

Product What it is
Yggdrasil the agentic factory
Asgard Yggdrasil's kickstart realm; moves under yggdrasil after Yggdrasil v0

Contributing

Run uvx pre-commit install once after cloning, so gitleaks checks each commit for secrets.

Licence

  • Documentation (this repository's main content): CC BY 4.0.
  • Scripts (scripts/): AGPL-3.0.
  • Names and logos are not licensed: see TRADEMARKS.md.
  • The products use AGPL-3.0 for factory code and MIT for anything copied into what operators build. What you build with Ouroboric factories is yours.
Languages
Shell 92.7%
Python 4.7%
Nix 2.3%
Jinja 0.3%