Účel
Repozitář se učí jedním směrem: něco se potká, zaznamená se to, někdo rozhodne, zda je to pravda, a to, co je pravda, změní, jak pracuje další worker. Každý orgán toho už tady existuje — pozorování, kandidáti odvození na konci epizody, povýšení a zamítnutí, pravidla, dovednosti, případy, odvozené plochy. Tato dovednost je pořadí, v jakém je použít, aby poučení nezůstalo jen poznámkou.
Není to druhé úložiště, systém bodování ani autonomní přepis. Nic se nepovýší bez důkazů a rozhodnutí, nic se nezapíše jinam než tam, kde druh už žije, a nic se nedostane na povrch jinak než odvozením ze souboru, který se změnil.
Kdy použít
Když relace skončí s něčím, co se naučila, když briefing jmenuje kandidáty čekající na revizi, po incidentu a kdykoli o to operátor požádá jménem. Konec epizody už odvozuje své kandidáty (session.knowledge_on_end); toto je to, co se s nimi dělá.
Postup
1. Shromážděte, o čem je třeba rozhodnout
majordomus knowledge candidates
majordomus knowledge checkPotom zaznamenejte, s čím se tato relace setkala a co ještě nezapsala, po jednom pozorování, do knihy a nikam jinam:
majordomus knowledge observe --kind defect --subject rule:project.every-wait-is-bounded \
--evidence test:test/cases/122_liveness_gate.sh "the scan read no build, so a silent build wait was not a finding"
majordomus knowledge derive --dry-runderive zapíše kandidáty této epizody; běh nanečisto je ukáže nejdřív. Zde odmítnuto: pozorování bez předmětu a poznámka uchovaná ve vlastním souboru místo v knize.
Tři věci, které příkaz odmítá, každou potkal první pracovník, který tento krok následoval:
- Pozorování patří epizodě. Ve worktree, kde žádná není otevřena, nejprve jednu otevřete pomocí
majordomus session start. --kindje jedno zfriction,workaround,defect,drift,repetition. Poučení je to, čím se kandidát stane po povýšení, ne druh pozorování.--subjectje cesta relativní k repozitáři, nebocapability:,rule:,command:čigate:následované identifikátorem. Test se pojmenovává svou cestou;test:je prefix--evidence, ne subjektu.
2. Rozhodni o každém kandidátovi
Kandidát je tvrzení, za kterým někdo musí stát. Přečti si jeho záznam a to, co pojmenovává, a pak jedno ze dvou, nikdy třetí:
majordomus knowledge promote <id> --class lesson < evidence.md
majordomus knowledge reject <id> --reason "<why, and what replaces it>"Povýšení vyžaduje důkazy na standardním vstupu: příkaz, test, commit či měření, které činí tvrzení pravdivým, ne jeho zopakování. Kandidát, který duplikuje kurátorskou poznámku nebo pravidlo, je odmítnut s identitou toho, co to už říká. Kandidát, který nedokážete posoudit, zůstává kandidátem; řekněte to ve zprávě místo hádání.
3. Dejte každé poučení tam, kde mění chování
Povýšená poznámka, kterou nic nečte, nic nemění. U každé se ptejte, co by zabránilo tomu, co popisuje, a proveďte tu změnu na místě, kde druh žije:
| poučení se týká | stane se | kde |
|---|---|---|
| něco, co se nesmí nikdy opakovat | pravidlo s validátorem nebo testem, nebo nový tvar v existující kontrole | .ai/repo/rules/, scripts/ci/, test/cases/ |
| jak dělat určitý druh práce | krok v dovednosti nebo workflow | .ai/repo/skills/, .ai/repo/workflows/ |
| co věc je nebo proč je taková | odstavec v dokumentu, který to už vysvětluje, nebo rozhodnutí | docs/, majordomus decision |
| volba mezi alternativami | záznam architektonického rozhodnutí | .ai/repo/adrs/ |
| fakt, který si musí pamatovat jen tento repozitář | samotná kurátorovaná poznámka | .ai/repo/knowledge/curated/ |
Pro změnu následujte majordomus://skill/implement. Zde odmítnuto: nový adresář, registr či databáze pro lekce; pravidlo bez možnosti rozhodnout; číslo, seznam nebo odkaz napsaný do stránky, kterou vlastní generátor.
4. Dokažte to
majordomus knowledge check
majordomus skills check
majordomus check
scripts/deriveSpusťte kontrolu všeho, čeho se změna dotkla, před derive, aby stačil jeden derive. Poučení o kontrole je prokázáno případem, který rozbije danou věc a sleduje, jak ji kontrola odmítne.
5. Doručit a nechat povrchy následovat
Commitni, předej změnu frontě přistání jako jeden pull request a čti stránky, které běží po jeho mergi. Web, publikovaná kopie produktového UI, generované stránky dovedností, zdroje MCP a instrukční soubor každého poskytovatele jsou projekce změněných souborů; žádný z nich se neupravuje a ten, který se nepohnul, je nález o svém generátoru. Pokud některá kapitola příručky říká, co se změnilo, změň ji ve stejném pull requestu.
6. Řekněte to všem, kdo tu pracují
Poučení, které se naučila jedna relace, má cenu toho, kolik z něj vědí ostatní. Oznamte na nástěnce, co se změnilo a kde, a publikujte předávku, která jmenuje pravidlo, dovednost nebo dokument a commit, aby ji relace spuštěná zítra přečetla ve svém briefingu:
majordomus handovera přes sdílený server schopnosti peers.announce a mesh.handover.publish (majordomus_announce, majordomus_mesh_handover_publish). Hlaste pod majordomus://skill/report-verification-state: co bylo povýšeno, co zamítnuto a proč, co se změnilo, co bylo dokázáno a co ne.
Výstup
- Každý posouzený kandidát je povýšen s důkazy, nebo zamítnut s důvodem; ti, o nichž se nerozhodlo, jsou jmenováni i s důvodem.
- Každé povýšené poučení, které žádalo změnu, ji má, na místě, kam jeho druh patří, s testem nebo validátorem, který o ní rozhoduje.
majordomus knowledge check,majordomus skills checkamajordomus checkprojdou a odvozené soubory jsou aktuální.- Změna je dodána nebo je jmenován její pull request, stránky běží poté, co byla přečtena, a nástěnka i předávka říkají, co se pohnulo.