Vzniklo při stránku po stránce probíhajícím review veřejného webu 2026-09-04. Zaznamenává, k čemu je každá trasa, odkud pochází její obsah, co se změnilo a proč a jak byl výsledek ověřen. Počty zde jsou psány ručně a zastarají; příkazy k jejich přepočtu jsou uvedeny.
Audit tras
| route | účel | publikum | zdroj | primární akce | podniknutá akce |
|---|---|---|---|---|---|
/ | rozpoznat problém, vidět model řízení, nainstalovat, vědět, co je zaručeno | zvídavý vývojář, vedoucí | sekce README, marketing.toml, generovaná data | Nainstalovat Majordomus | IMPROVE: hero se zaměřením na bolest; tok režimů selhání s „kdo to kontroluje?“; prohlášení o hranici (odmítnuté přijetí, ne prevence za běhu); před/s; jedno primární CTA; profily, principy, karty devíti odpovědností a pipeline webu přesunuty na své stránky |
/why/, /why/<slug>/ | pět okamžiků, které tým pozná, každý vysvětlený a ohraničený | zvídavý vývojář | site/content-src/why/ | přečtěte si případ, pak příkazy | ZACHOVAT (přidáno dříve dnes večer); každé propojuje odpovědnosti, příkazy, tvrzení |
/getting-started/ | nejkratší pravdivá cesta k repozitáři pod dohledem | vývojář | project.json, policy.json | spustit příkazy | PONECHAT |
/supervises/, /supervises/<slug>/ | devět odpovědností a deset principů | vyhodnocovač | řádky README, tvrzení podle klíčového slova | přečíst odpovědnost | IMPROVE: principles moved here from the homepage |
/commands/, /commands/<name>/ | jedna stránka na příkaz z reference CLI | stávající uživatel | sekce docs/CLI.md | přečtěte příkaz | ZACHOVAT; stránky příkazů vypisují tvrzení, která implementují |
/profiles/, /profiles/<slug>/ | každé pole každého profilu | hodnotitel, stávající uživatel | profiles.json | zvolit profil | ZACHOVAT; poradní claimy propojeny |
/policy/ | kanonická politika jako struktura i jako text | stávající uživatel | policy.json | upravte politiku | ZACHOVAT; tvrzení definovaná politikou propojena |
/guarantees/ | úplná matice nároků | skeptický inženýr | capabilities.json | ověřit řádek | ZACHOVAT; každý řádek odkazuje na svou stránku |
/guarantees/<status>/ | jeden status najednou | skeptický inženýr | capabilities.json | vyberte tvrzení | PONECHAT |
/guarantees/<id>/ | podrobné tvrzení: význam, mechanismus, jak to vidět, limity, důkazy, provenience, testovací příkaz, kde se používá | skeptický inženýr | docs/claims/<id>.md, capabilities.json | spustit test | IMPROVE: podrobné dokumenty přidány pro všechna tvrzení |
/limitations/ | co v0.1 nedělá | vyhodnocovač | README „Limitations“ | přečíst plán rozvoje | GENERATE (nové) |
/roadmap/ | co přijde dál, kontrolováno | vyhodnocovač | README „Roadmap“ | číst plánovaná tvrzení | GENERATE (nové) |
/architecture/ | jak se web odvozuje | maintainer | content-src/architecture.md, source.json | přečíst dokument o architektuře | PONECHAT |
/docs/, /docs/<doc>/ | dlouhé dokumenty tak, jak je ukazuje GitHub | přispěvatel, hodnotitel | docs/*.md | read | ZACHOVAT; každé vypisuje tvrzení, která definuje |
/concepts/ | ukazatel na dokument slovníku | — | zástupka | — | ODSTRANIT (navigace míří na /docs/concepts/) |
/render-test/ | referenční vykreslení pro validaci | maintainer | content-src/render-test.md | — | KEEP, noindex |
404.html | nenalezeno | kdokoli | šablona | zpět na začátek | PONECHAT |
Přepočet: find site/public -name index.html | wc -l po scripts/site-build.
Výroky o hranici vynucování
Každá veřejná věta používající prevent / block / enforce / refuse / detect / verify byla vypsána (grep přes marketing.toml, content-src, docs/claims, šablony) a klasifikována. Žádná netvrdí prevenci za běhu. Kontrakt uvedený na domovské stránce a na stránkách tvrzení o dokončení zní: Majordomus předem deklaruje rozsah, soubor mimo něj zjistí při check a finish a odmítne přijmout práci jako dokončenou; háky, které spouštějí doctor a finish --check, blokují commit nebo push jen tam, kde je repozitář zapojil, což ověřuje samotné doctor. Tvrzení týkající se profilů ve svém textu říkají, že jsou doporučující.
Kanonické vlastnictví faktů webu
| fakt | kanonický domov | dorazí na web přes |
|---|---|---|
| verze, příkazy, návratové kódy | bin/majordomus | project.json, commands.json |
| slogan, důkaz problému, co dělá, čím není, omezení, plán rozvoje | README.md podle nadpisu | readme.json |
| profily | share/skeleton/profiles/*.yaml | profiles.json |
| policy | share/skeleton/policy.yaml | policy.json |
| deset zásad | share/standard/majordomus/rules/principle-*.md | lifecycle.json |
| výsledky | lib/finish.sh | lifecycle.json |
| tvrzení a jejich stav | docs/CLAIMS.yaml | capabilities.json, docs/SITE_CLAIMS.md |
| detail tvrzení | docs/claims/<id>.md | těla stránek tvrzení |
| dlouhé dokumenty | docs/*.md přes docs/README.md | docs.json, content/docs/ |
| případové studie a jejich háčky | site/content-src/why/*.md | sekce why |
| navigace | site/data/nav.toml | navigační lišta |
| marketingový text | site/data/marketing.toml | domovská stránka vede |
Nic na webu se neparsuje z CLAUDE.md ani AGENTS.md; ty jsou samy projekcemi osetých workflow pod share/skeleton/ai/repo/workflows/.
Provedená validace
bash test/run.sh every case in test/cases, each in a disposable repository
scripts/generate-site-data --check derived data matches canonical inputs
scripts/site-build Zola + Tailwind + vendored JS
scripts/site-check sync, schema, promo budget, routes, prefix, links, assets,
dark CSS scoping, offline, JS hooks, Mermaid runtime,
mobile lint, private paths, secrets, docs coverage, tiles,
navigation, claim links, claim count
scripts/site-probe every route × {320, 390, 1280} px in headless Chrome:
scrollWidth == clientWidth; Mermaid rendered; mobile menu,
dropdown and theme toggle exercisedPřed / po
Předtím: čtrnáct sekcí úvodní stránky; devět navigačních odkazů stejné váhy; problémová próza README zopakovaná pod hákem, který ji už říkal; tvrzení zmíněná jako prostý text; žádné stránky pro omezení nebo plán rozvoje; stub /concepts/, který jen odkazoval jinam; responzivita ověřená ručně.
Potom: osm sekcí domovské stránky v pořadí trychtýře s jednou hlavní akcí; pět navigačních záměrů s rozbalovacími nabídkami; tok režimů selhání a výslovné vyjádření hranice vynucování; každá zmínka o tvrzení odkazuje na podrobnou stránku; omezení a plán rozvoje generované z README; zástupná stránka odstraněna; test v prohlížeči v CI.
Zbývající omezení
- Přístupnost byla prověřena čtením markupu a vyzkoušením ovládacích prvků v headless Chrome; neproběhl žádný čtečkou obrazovky ani automatizovaným skenerem a11y.
- Mermaid se načítá na stránkách s diagramy; balík je velký a načítá se jen tam.
- Křížové odkazy odpovědnost→tvrzení používají v generátoru mapu klíčových slov; nové tvrzení, jehož text nepoužívá žádné z klíčových slov, se na stránce odpovědnosti neobjeví, dokud se mapa nerozšíří.