Co to znamená
Vrstva AI je hierarchická. Adresář pod .ai/ může nést kontextový dokument: soubor Markdown, jehož front matter deklaruje schema: context/v1 a kind: context, id, které je jeho identitou bez ohledu na název souboru, kde platí (scope: jeho adresář, jeho podstrom nebo adresáře, které uvádí), které poskytovatele a publikum oslovuje a jak se skládá s tím, co platí nad ním (extend, replace jmenující, co nahrazuje, nebo final, které žádný potomek nesmí nahradit). Platný kontext pro cestu je každý použitelný dokument od kořene stromu až po cílový adresář, nejméně specifický první, a každý záznam říká, proč tam je.
Princip
lib/context_docs.sh projde strom jednou, v pořadí kolace C, přeskočí lokální polovinu a vendorovaný balíček pravidel a soubor přijme podle jeho kontraktu, nikdy podle jména; jména, která manifest uvádí pod context.documents, musí kontrakt nést, ať se objeví kdekoli. Každý dokument se kontroluje proti povoleným klíčům, povinným klíčům, slovníkům hodnot a providerům, které politika promítá; poté napříč dokumenty na jedinečné id, odkazy, které se vyřeší v řetězci předků, žádný nahrazený dokument final a žádný cyklus. Rozlišení seřadí použitelné dokumenty podle hloubky, pak order, pak cesty, zahodí to, co nahrazuje replace níže, filtruje podle --provider a --audience a vytiskne otisk uspořádaných id, cest a hashů obsahu. Cesta mimo strom dostane kořenový řetěz plus každý dokument, jehož pathspecs tracks ji pokrývají.
Jak to vidět
majordomus context list # every document, in resolution order
majordomus context explain .ai/repo/rules/project # the chain, why each applies, what was left out
majordomus context resolve lib/rules.sh --provider claude-code --json
majordomus context validate # exit 10 with every problem named, or 0Co nepokrývá
Nástroj skládá uspořádaný seznam dokumentů; nikdy nesluče jejich Markdown, neřadí jejich prózu ani nerozhoduje, že jedna věta odporuje jiné. Zda je dokument správný, je úsudek čtenáře; zda je tam, kde říká, že je, a platí pro to, o čem mluví, je věc nástroje.
Proč existuje
Vždy načítaný kořenový soubor je místo, kde skončí každé pravidlo, když nic neříká, kam patří, a ten soubor byl naměřen oscilující mezi ničím a asi tisícem řádků. Kontrakt, který nechá kontext žít vedle věci, kterou popisuje, a resolver, který dokáže, že řetěz od rootu k cíli je jeden deterministický seznam, udržují root tenký, aniž by se ztratil zbytek. test/cases/69_context_documents.sh rozbíjí strom po jednom faktu a dokazuje, že každé rozbití je odmítnuto jménem.