Documentation

flowchart LR
    START([New here?]) --> GS["<b>Getting started</b><br/>run it, fly it"]
    GS --> VIS["<b>Vision</b><br/>what it is for"]
    VIS --> ARCH["<b>Architecture</b><br/>the shape of the system"]
    ARCH --> CONCEPTS["<b>Concepts</b><br/>how each mechanism works"]
    CONCEPTS --> ADR["<b>ADRs</b><br/>why, and what was rejected"]
    ARCH --> GUIDES["<b>Guides</b><br/>how to work on it"]
    ARCH --> ROADMAP["<b>Roadmap</b><br/>what is not built yet"]
    ROADMAP --> SPIKES["<b>Spikes</b><br/>what was measured"]
    VIS --> DESIGN["<b>Design bible</b><br/>what the game is"]

    classDef entry fill:#0ea5e9,stroke:#0369a1,color:#fff
    class START entry

flowchart TB
    subgraph Orientation
        RM[README.md]
        DOC[docs/README.md]
        VISION[vision.md]
        GLOS[glossary.md]
        STYLE[STYLE.md]
    end

    subgraph Designing
        DESIGN[design/]
    end

    subgraph Understanding
        ARCH[architecture.md]
        CON[concepts/]
        ADR[adr/]
    end

    subgraph Working
        DEV[guides/development.md]
        GUIDE[guides/]
        AG[AGENTS.md]
        AH[docs/agents/]
        CTX[CONTEXT.md]
        ROAD[roadmap.md]
    end

    RM --> DOC
    DOC --> VISION
    DOC --> STYLE
    VISION --> DESIGN
    DESIGN -.->|"seams"| ROAD
    VISION --> ARCH
    ARCH --> CON
    CON <--> ADR
    ARCH --> GUIDE
    AG --> AH
    AH --> DEV
    ROAD --> CTX
    CON -.->|"terms"| GLOS

    style DOC fill:#0ea5e9,stroke:#0369a1,color:#fff