Kontext
Kořen správy je psaný, ne generovaný. Nese úsudek, který žádný nástroj nevytvořil a žádný by neměl přepsat. Adopce se zde obvykle zasekne, protože zřejmá integrace je, že soubor vlastní nástroj.
Repozitář, jehož pravidla psali lidé
Už existuje CLAUDE.md, AGENTS.md nebo ekvivalent, který někdo napsal a ostatní se jím řídí.
Hodí se, když
- Psaný text má zůstat autoritativní a generovaná sekce může sedět uvnitř něj
- Vynucování už existuje jako git hooky, včetně dispatcherů nad adresářem hook.d
- Pravidla jsou zapsána a nikdo nemůže aktuálně dokázat, která z nich běží
Nehodí se, když
- Repozitář chce jediný generovaný instrukční soubor a rád předá vlastnictví
- Zatím není žádná governance k dozoru, v takovém případě začněte dodanou kostrou
Oba seznamy jsou povinné. Položka, která deklaruje jen to, co se hodí, je odmítnuta generátorem i příkazem majordomus doctor.
Co byste zde udělali
- Nainstalujte nástroj jedním příkazem na stroji bez toolchainuVložte jeden řádek, získejte ověřený binární soubor pro tento stroj a spusťte majordomus init — bez gitu, bez Rustu, bez Node, bez Pythonu, bez roota a bez možnosti nainstalovat archiv, jehož digest nesouhlasí.zaručeno version · init · doctor
- Převzetí repozitáře, který už má vlastní pravidlaNainstalujte dozorovou vrstvu do repozitáře s ručně psaným CLAUDE.md, aniž by nástroj převzal vlastnictví souboru, který napsal někdo jiný.zaručeno init · update · doctor
- Dokázat, že pravidlo je skutečně vynucováno, a ne jen zapsánoOdpovědět na "je toto pravidlo skutečné?" příkazem, ne čtením zdroje.zaručeno doctrine · doctor · check
- Zjistěte, co se od posledního pohledu změniloPtejte se, co se pohnulo, místo toho, zda je něco špatně.zaručeno watch · update · history
- Rozšířit, co spustitelný soubor poskytuje, přidáním souboru, nikdy jeho přebuildovánímPřidat do .ai/ pravidlo, prompt nebo uzel znalostí a nechat ho objevit se jako MCP resource, HTTP route a položka reference, se stejným binárním souborem.záruka init · update · doctor · knowledge
- Přidat případ užití a nechat nástroj dokázat jejVytvořit koncept pro nepokrytý příkaz, validovat ho, spustit jeho scénář proti skutečnému nástroji a sledovat, jak se pokrytí posouvá.zaručeno usecase · doctor
- Přesunout repozitář z rozložení před .ai do vrstvyZjistěte, co by migrace přesunula, přesuňte to se zálohou a dokažte, že výsledek je vrstva, kterou nástroj čte.zaručeno migrate · doctor
- Zjistit, která pravidla se zde uplatňují a co je vynucujeVypsat platná pravidla, přečíst jedno pravidlo tak, jak ho čte nástroj, a zjistit, která z nich nástroj vynucuje a odkud.záruka rules · doctrine
- Rozhodnout, co patří do kontextu AI, jako dataPřečíst deklarovanou politiku rozsahu repozitáře, zjistit, které cesty jsou v indexu a které mimo, a nechat doctor a index znalostí aplikovat ji místo napevno zapsaného seznamu.záruka knowledge · doctor
- Držet každý bootstrap poskytovatele tenký, generovaný a v rozpočtuZnovu vygenerovat AGENTS.md, CLAUDE.md a ostatní soubory poskytovatelů z jedné politiky a dokázat, že jsou orazítkované, míří na vrstvu, drží se pod rozpočtem řádků a vyřeší každý odkaz.zaručeno update · doctor · watch
- Vystopovat změnu k dokumentům kontextu, které ovlivňujeVypsat dokumenty kontextu s rozsahem, určit, které se vztahují na cestu a proč, a zjistit, kterých dokumentů se dotýká sada změn, než přistane.zaručeno context · doctor
- Odmítnout adresář vrstvy, který nic nedokumentujeAdresář přidaný pod vrstvu bez kontextového dokumentu selže při validaci jménem, nic se proti stromu neřeší, dokud neřekne, k čemu je, a tatáž hierarchie je čitelná přes MCP a API bez spuštění kontroly.zaručeno context · doctor
- Politice a profilům důvěřujte až po jejich ověřeníDokažte, že kanonická politika se zpracuje se všemi deklarovanými klíči, které potřebuje, že se zpracuje každý profil a výchozí existuje, a že to, co politika deklaruje jako vynucené, je to, co skutečně běží.zaručeno doctor · kontrola
- Následujte postup, který repozitář definuje, a přidejte dalšíPřečtěte dovednosti repozitáře, vezměte jednu tak, jak je napsána, a novou přidejte napsáním jejího souboru — bez registru, bez kódu a s kontrolou, která říká, co zkoumala.zaručeno skills
- Podívat se, co repozitář obsahuje, a spustit jednu z jeho schopností, bez čtení souboruOtevřete sdílený server v prohlížeči a získejte celou vrstvu jako stránky: co existuje, odkud co pochází, co na čem závisí, co selhává, a formulář, který spustí libovolnou schopnost.zaručeno doctor · knowledge
- Řekněte jednou, k čemu je vaše práce, a ať to říká každý povrchZaznamenejte provozní režim selhání jako jeden soubor a nechte na něj odpovídat příkazový řádek, API, MCP i web, aniž byste ho kamkoli registrovali.zaručeno init · context · knowledge · doctor
- Zachovejte, co se epizoda naučila, bez modelu a bez konverzaceZaznamenejte rozhodnutí uvnitř epizody, odvoďte ho z ledgeru do kandidáta znalostního záznamu, přečtěte důkaz, že odvození proběhlo, a sledujte, jak druhé odvození nic nezmění.zaručeno start · decision · knowledge · history