Skip to content

How this site is derived

The website is a projection of the repository, built the way the tool asks projects to build their own instructions.

Ownership

layerownslives in
product truthpolicy schema, profiles, worker instructions, the CLIshare/skeleton/**, bin/, lib/
public narrativewhat it is, why, how, what it refusesREADME.md, docs/**
claimsevery capability, with status, source, implementation, testdocs/CLAIMS.yaml
marketing copyheadline, leads, button labels; no claims, no numbers, a line budgetsite/data/marketing.toml
derived datastable JSON the templates readsite/data/generated/** (committed, checked)
derived contentcanonical Markdown with generated front mattersite/content/docs/** (gitignored, rebuilt)
presentationZola templates, Flowbite components, Tailwind utilities, Alpine enhancementssite/templates/**, site/tailwind.css
outputthe static sitesite/public/**

Pipeline

share/skeleton + docs + README + CLAIMS.yaml
        │  scripts/generate-site-data
        ▼
site/data/generated/*.json  +  site/content/docs/*.md
        │  zola build
        ▼
site/public/          ← Tailwind + Flowbite CSS, Flowbite JS, Alpine
        │  GitHub Actions (pages.yml)
        ▼
GitHub Pages

Sync guarantee

scripts/generate-site-data --check regenerates into a temporary directory and diffs it against the committed site/data/generated/. A difference fails the build. The input hash in source.json covers every canonical file the generator reads; it appears in the footer of every page. A regression test changes one canonical value in a scratch copy and asserts the derived data changes with it, so the derivation is proven rather than assumed.

What is never edited by hand

site/data/generated/**, site/content/docs/**, site/static/app.css, site/static/js/**, site/public/**. Change the canonical file; rebuild.

How this site is derivedfrom generate-site-data inputs
flowchart LR
    subgraph canonical
        A[share/skeleton]
        B[docs + README]
        C[docs/CLAIMS.yaml]
    end
    G[scripts/generate-site-data]
    D[(site/data/generated)]
    Z[Zola]
    F[Tailwind + Flowbite + Alpine]
    P[GitHub Pages]
    A --> G
    B --> G
    C --> G
    G --> D --> Z --> F --> P
Policy to instruction filesfrom share/skeleton/policy.yaml projections
flowchart TD
    P[.ai/repo/policy.yaml]
    U[majordomus update]
    P --> U
    U --> T0["AGENTS.md<br/><small>agents</small>"]
    U --> T1["CLAUDE.md<br/><small>claude-code</small>"]
    U --> T2["GEMINI.md<br/><small>gemini</small>"]
    T0 -.->|stamp| D[majordomus doctor]

This page is about the website. For the program the website is about — every module of the CLI and every file it reads and writes, scanned out of the shell sources on each build — see the program map.