Mysterium

A contemplative practice that uses game mechanics as its delivery vehicle: every encounter simultaneously diagnoses and heals/evolves the player across all lines of development, with Law-of-One cosmology as canon.

Every document in docs/ is listed with the question it answers in docs/PAGE-INDEX.md.

Start here

If you are…	Read
looking for decisions or past failures	docs/system/core/decisions/ · docs/system/core/regressions/
needing the context for a component	python3 scripts/arch.py context src/core/<organ-path>
searching the knowledge-base	python3 scripts/arch.py search <keyword>

The documentation rungs

canon-root   docs/00-vision · 01-first-principles · 02-glossary · 03-research-methodology
canon        docs/foundations/          theory — "what is true"
canon-domain docs/{lines,stages,narrative,progression}/
content      docs/concept-drafts/       512-file corpus
system       docs/system/               contracts, as 13 organs
records      docs/system/core/          AD · RG · Log   (decisions, guards, ledger)
plans        docs/{DEVELOPMENT,ONBOARDING-REDESIGN,ARCHITECTURE-TRANSMUTATION}-PLAN + REQUIREMENTS
historical   docs/historical/           dated; never an authority
audits       docs/audits/               dated evidence; never an authority
generated    docs/INDEX.md + docs/system/sub-systems/*/AGENTS.md   (never hand-edited)

Declared machine-readably in _org.yaml. Query the knowledge-base with:

python3 scripts/arch.py validate          # the doc-governance gates (DG1-DG19)
python3 scripts/arch.py fixtures          # prove every gate fails on an injected violation
python3 scripts/arch.py route <path>      # which rung/organ owns this file or code path?
python3 scripts/arch.py context <path>    # contract docs + organ documents + records
python3 scripts/arch.py search <keyword>  # BM25 search over the live knowledge-base
python3 scripts/arch.py related <path|ID> # outbound edges, backlinks, and missing-link suggestions
python3 scripts/arch.py doc add --organ O --title T   # author documentation (refuses to create an orphan)
python3 scripts/arch.py emit               # regenerate the derived surfaces

Development

npm run build && npm test                 # build + 1120 tests
python3 skills/workspace-lint/scripts/workspace_lint.py --root .
python3 scripts/arch.py validate

The mandatory iteration sequence is in AGENTS.md §7.5.

This README is a pointer, not a second router. Governance content lives in AGENTS.md (one > canonical document per directory); if this file grows beyond pointers, that is a defect.