Dostupné
Governance a role
Repozitář, ve kterém píše kód i agent, potřebuje pravidla zapsaná jako soubory, ne jako zvyk. Governance vrstva tady není dokumentace o kódu — je to vstupní podmínka práce a validátory ji kontrolují stejně jako typy.
- Kořen
CLAUDE.md— produkt, hranice, povinný postup session- Role
- sedm, v
AGENTS.md, každá s výčtem zakázaných akcí - Moduly
- 6 v
.claude/modules/: core, development, quality, security, git-workflow, isir - Politiky a ADR
- 21 politik v
.aiad/policies/, 7 ADR v.claude/adr/ - Kontrola
just quality— governance-caps, skills-layer, orchestration-contract
Role je omezení, ne titulek
Každá ze sedmi rolí má vlastní seznam toho, co dělat smí, a — což je důležitější — co dělat nesmí. Dokumentarista nepíše implementaci, inženýr zdroje nemění limity fetchování bez review, nikdo neoslabuje bránu kvality, aby prošel commit.
Session pracuje vždy v jedné roli. Přepnutí role uprostřed práce je legitimní, ale musí být zapsané, protože z něj plyne, jaká validace je povinná na konci.
Politiky, protože pravidlo bez místa se ztratí
Politika je jeden soubor pro jedno pravidlo: česká právní přesnost, anti-halucinace, formát commitu, integrita odkazů v markdownu, podmínky zdroje, autocommit session. Když se pravidlo změní, mění se jeden soubor a diff je viditelný.
Architektonická rozhodnutí mají vlastní formu. ADR zaznamenává, co se rozhodlo, jaké alternativy padly a co to stojí — včetně rozhodnutí o clean-room vztahu k sesterskému repozitáři a o tom, že jednotkou modelu je dílčí pohledávka, ne přihláška.
Co to nezaručuje
Governance vrstva nedělá kód správným. Zajišťuje jen to, že špatný krok je viditelný v diffu a že se na něj někdo dá odkázat. Kvalita dat pořád stojí na extrakci, prahu spolehlivosti a lidské kontrole — a ty zatím neexistují.
Kde to v repozitáři žije
CLAUDE.md— kořenová pravidla: produkt, clean-room, jazykové pravidlo, povinný postup sessionAGENTS.md— sedm rolí, jejich povolené a zakázané akce, pořadí práce a eskalace.aiad/policies/README.md— rozcestník 21 politik.claude/adr/README.md— registr architektonických rozhodnutí
Souvisí
Brány kvality
DostupnéTřiatřicet kroků v jednom deklarativním manifestu: 27 governance validátorů a 6 kroků toolchainu. Oslabení brány je viditelné v diffu, protože rozbije zamčený test.
Detail
Git Enforcement OS
DostupnéHooky pro commit-msg, pre-commit a pre-push, skládané z očíslovaných fragmentů. Formát commitu s dokumentárním tělem je vynucený, ne doporučený.
Detail
Session lifecycle
DostupnéOtevření a uzavření pracovní session, session-context soubory s ověřovanou lineage a generovaný statický DX report. Provozní paměť repozitáře, ne deník.
Detail