Slovník v běžném inženýrském jazyce. Všechno, co Majordomus vypisuje, a každý soubor, který zapisuje, používá tato slova a žádná jiná.
| Pojem | Význam | Kde to žije |
|---|---|---|
| policy | jediná kanonická provozní politika nezávislá na poskytovateli | .ai/repo/policy.yaml |
| profil | pojmenovaný svazek, který pro třídu úloh určuje třídu schopností, úsilí, výřečnost, prezentaci, přepínače kontextu, ověřování, interval checkpointů a výstupní smlouvu | .ai/repo/profiles/<name>.yaml |
| projekce | instrukční soubor specifický pro poskytovatele, generovaný z politiky, opatřený razítkem pojmenovávajícím příkaz, který jej znovu generuje, hash politiky a hash vlastního obsahu | CLAUDE.md, AGENTS.md, GEMINI.md nebo jakýkoli cíl, který politika jmenuje |
| stamp | první řádek generovaného souboru nebo začátečná značka generované oblasti: hash politiky, ze které byl vykreslen, a hash obsahu, který pokrývá; obsah odlišný od svého razítka byl upraven ručně | <!-- generated by \majordomus update` ... (policy ..., content ...) -->` |
| úloha | jediná aktivní jednotka práce v checkoutu | .ai/local/state/current.yaml |
| session | jedna epizoda provádění jednoho pracovníka: otevírá se, může se dotknout několika úloh a uzavírá se do neměnného záznamu, který odkazuje na to, co epizoda vytvořila, a nic z toho nekopíruje | .ai/local/state/sessions-open/<provider session>.yaml dokud je otevřená — jedna epizoda na relaci poskytovatele, přičemž session-current.yaml ukazuje na epizodu tohoto checkoutu — pak .ai/repo/sessions/ po uzavření |
| záznam znalostí | jedno tvrzení o repozitáři s třídou, stavem, epistemickým postojem a provenancí, která se rozřeší; candidate je to, co nástroj odvodil z účetní knihy a gitu na hranici epizody, verified je to, co člověk povýšil s důkazy, a ani jedno není nikdy konverzací | .ai/repo/knowledge/candidates/<id>.md, .ai/repo/knowledge/curated/<id>.md, knowledge derive, knowledge promote, majordomus://knowledge/<id> |
| pozorování | jeden řádek, který worker napíše o tření, na které narazil — jeho druh (friction, workaround, defect, drift, repetition), čeho se týká, tvrzení a typovaný důkaz — který hranice epizody promění v kandidáta říkajícího, čím je about, a jeho route (platform, enforcement, generator, documentation, project), čtené ze struktury předmětu; opakování jsou kandidáti o jednom předmětu, seskupení při čtení | knowledge observe, observation.recorded, knowledge candidates (skupiny) |
| obálka | co je uzavřený záznam relace: identita, časová hranice a reference — nikdy kopie záznamů, které jmenuje | .ai/repo/sessions/<file>.md |
| scope | normalizovaná množina cest repozitáře, kterých se úloha smí dotknout nebo na které se kontextový dokument vztahuje; a pro repozitář jako celek, co z něj pracovník čte a co nikdy nečte, deklarováno jednou, out přednost před in, cesta, která nesedí na nic, je out | scope: v záznamu úlohy; scope: a paths: v kontextovém dokumentu; .ai/repo/scope.yaml, čtený příkazy scope a majordomus://scope |
| claim | tentýž rozsah, viděný z jiného worktree; překryv se hlásí, nikdy neblokuje | hlásí start a check --overlap |
| případ užití | úloha, kterou člověk provádí s nástrojem, jako jeden objekt: příkazy, pravidla, tvrzení, odpovědnosti a aplikace, které jmenuje, a scénář, který nástroj proti sobě provede; její zralost se pozoruje z důkazů, nikdy se nepíše | .ai/repo/use-cases/<id>.md, usecase, majordomus://use-case/<id>, /use-cases/<id>/ |
| aplikace | kontext, pro který nástroj vyhovuje: kdy se hodí, kdy ne a případy užití, které skládá | .ai/repo/applications/<id>.md |
| kontrolní bod | kompaktní záznam postupu uvnitř aktivní úlohy, omezený politikou, aby zůstal citovatelný a nestal se zprávou; aktualizuje také checkpoint_at, z něhož se měří zastarání | .ai/local/state/checkpoints/, checkpoint, check --checkpoint |
| handover | záznam o pokračování jen s přidáváním, s vypočteným front matterem a povinnými sekcemi, zapsaný, když worker končí; publikovaný pro jiný stroj jako podepsaný záznam nesoucí jen přenosný stav a tam obnovený podle plánu, který zkontroloval důvěru, linii a zdroj | .ai/local/state/handovers/; publikováno: refs/majordomus/continuity, continuity publish, sync, plan, resume |
| rozhodnutí | co bylo rozhodnuto, proč, co bylo zamítnuto a která úloha rozhodla; nahrazuje se pozdějším záznamem, který je jmenuje, nikdy se neupravuje | .ai/local/state/decisions.md |
| otevřená otázka | něco nevyřešeného, zaznamenané jako stav, ne jako próza; každá položka, která jmenuje aktivní úlohu, odmítne finish --outcome completed | .ai/local/state/open-questions.md |
| pravidlo | přenosný dokument Markdown s YAML front matter: identita, třída, závislosti a u těch, která nástroj vynucuje, blok x-majordomus; efektivní množina je vendorovaný základ plus vlastní pravidla repozitáře | .ai/repo/rules/vendor/majordomus/rules/*.md, .ai/repo/rules/project/*.md, čtené pomocí rules list |
| doktrína | pravidlo, které nástroj vynucuje: jeho blok x-majordomus pojmenovává validátor, který o něm rozhoduje, příkazy, které ho spouštějí, a testy, které ho dokazují; blocking příkaz zastaví, advisory jen hlásí | vyřešená sada pravidel, čtená doctrine, check --rule a každým vynucujícím příkazem |
| validátor | funkce, která rozhoduje jednu doktrínu; hlásí zjištění a nikdy nerozhoduje o jejich úrovni, protože tu určuje třída doktríny | mj_validate_<name> v lib/ |
| událost historie | jeden řádek knihy: co se stalo, kdy, pro kterou úlohu, u kterého headu | .ai/local/state/ledger.jsonl, čte history |
| kontext | složený briefing pro toho, kdo pracuje dál: trvalý stav v pořadí autority, v rámci rozpočtu řádků, s pojmenovaným každým vyloučením | vypisuje context; nikdy se neukládá |
| kontextový dokument | soubor Markdown pod stromem .ai/, jehož front matter deklaruje schema: context/v1 a kind: context: identitu, která přežije přesun, rozsah (jeho adresář, jeho podstrom nebo vyjmenované cesty), poskytovatele a publikum, jimž je určen, a jak se skládá se svými předky | .ai/**/README.md; soubor jmenuje to, co vyžaduje context.documents manifestu |
| efektivní kontext | dokumenty, které se vztahují na jednu cestu, spočtené: řetězec předků připuštěný rozsahem každého dokumentu, od nejméně specifického, pak order, pak cesta; filtrováno podle poskytovatele, publika a stavu; nahrazené dokumenty se vynechají, final se nikdy nenahrazují | context resolve <path>; context explain říká proč |
| pořadí autority | git, pak úloha a profil, pak blokátory, pak psané záznamy, pak historie — pořadí, v němž se sekce objevují, a opak pořadí, v němž se vypouštějí | context |
| dovednost | postup nezávislý na poskytovateli pro jeden omezený druh práce: front matter podle schématu dovednosti nad tělem s účelem, postupem a výstupním kontraktem; nalezeno zdrojovou třídou skill, nikdy neregistrováno, načteno jen když se úloha týká právě jeho | .ai/repo/skills/<id>/SKILL.md, skills |
| pracovní kontext | ohraničený kontext jedné epizody provádění, skládaný při každém čtení z otevřeného záznamu epizody, gitu nyní proti gitu při otevření a z checkpointů, rozhodnutí a otázek, které nesou její vlastní řádky ledgeru; vedle něj úvodní snapshot toho, co builder vyřešil při otevření epizody, zmrazený jako důkaz. Lokální a zůstává lokální — jmenuje jeden stroj — a nikdy přepis | session context; snapshot .ai/local/session-contexts/<stamp>--<session-id>.md, session context --path |
| prompt asset | malé, verzované, na poskytovateli nezávislé zarámování v repozitáři, vykreslované proti uzavřené množině stavových tokenů | .ai/repo/prompts/<name>.md, prompt |
| rozlišení záznamu | výběr správného předchozího záznamu: stejný worktree a větev, jinak stejná větev, jinak nic — nikdy v rámci celého repozitáře | handover --resolve, checkpoint --show, context |
| výsledek | jedno z active, completed, partial, blocked, no_match, failed, handed_over; jediné pole, které příkaz mění po start | outcome: v záznamu úlohy |
| kontrakt příkazu finish | kontrolní seznam, který finish vyhodnotí před přijetím completed; každý řádek vypsán jako pass nebo fail | verification.finish_requires v politice |
| kniha záznamů | události jen k připisování, zapisuje je pouze Majordomus; retence je omezena | .ai/local/state/ledger.jsonl |
| zapojeno | vynucování, jehož spustitelný soubor se rozliší a je vyvolán, bez spolknutého návratového kódu, hookem nebo souborem CI, které politika jmenuje | kontroluje doctor |
| drift | deterministický rozpor mezi politikou, projekcí, stavem a gitem | hlášeno watch |
| štítek rozcházení | exact, advanced, diverged, different_context: jak se zaznamenaná hlava vztahuje k aktuální | počítáno při čtení z gitu |
| třída schopnosti | fast, standard, strong, strongest; nikdy název modelu konkrétního dodavatele | capability: v profilu |
| effort | low, medium, high, xhigh, max; hloubka uvažování, nezávislá na všem ostatním | effort: v profilu |
| podrobnost | terse, concise, detailed; kolik pracovník řekne, nezávisle na tom, jak usilovně přemýšlí | verbosity: v profilu |
| prezentace | machine, engineering, summary; konečná vrstva, zvolená profilem | presentation: v profilu |
| schopnost | jedna věc, kterou spustitelný soubor v Rustu vystavuje: typovaný dotaz s jedním handlerem, nebo deklarativní objekt vrstvy čtený jako zdroj; definováno jednou, s kanonickým id, a promítnuto do MCP, HTTP, OpenAPI, příkazové řádky a vygenerované reference | apps/majordomus-cli/src/capability/, majordomus capabilities list |
| provádění | jedno volání jedné schopnosti, kterému byla dána identita, aby se dalo sledovat, místo aby se na ně čekalo: životní cyklus, vstup tak, jak byl uložen, typované události a výstup nebo chyba. Žije v procesu, který ho přijal, a nepřežije ho | majordomus run, majordomus executions, /api/v1/executions*, /cockpit/executions |
| událost provedení | jeden typovaný fakt o provedení — vytvořeno, spuštěno, krok, průběh, řádek logu, diagnostika, zrušeno, dokončeno, selhalo — v obálce s verzí protokolu a souvislým pořadovým číslem; táž hodnota, ať se čte přes živý kanál, přes HTTP nebo na příkazové řádce | majordomus executions events, GET /events |
| preflight | co je o checkoutu dokázáno, na rozdíl od toho, čím je: verdikt za každé tvrzení — git, epizoda, briefing, úloha, předávka, politika, pravidla, ADR, sdílený server a jeho povrchy, peeři, zaznamenané běhy testů, vynucování pravidel, projekce, generované dokumenty, nasazení — každý s důkazy, na nichž stojí; hodnota, kterou vykresluje každý vstupní povrch | majordomus env preflight, /api/v1/environment/preflight, majordomus://environment/preflight, přehled Cockpitu |
| verdikt | verified, active, fresh, stale, degraded, unavailable, failed, unknown, not_applicable: co repozitář dokáže ukázat o jednom tvrzení; první tři nelze vytvořit bez důkazů | verdict: kontroly preflightu |
| režim vynucování | jak se pravidlo vynucuje, odvozeno z toho, co jmenuje jeho blok x-majordomus, a nikdy nedeklarováno: dispatched (validátor, který spouští příkaz), gated (testy, které spouští kontrola CI), reviewed (jen uvedený důvod, proč to žádný stroj nemůže zkontrolovat), declarative (nic) | majordomus-cli rules report, ADR 0048 | | důkaz pravidla | kde vynucování jednoho pravidla skutečně stojí: proven, inputs_unchanged, stale, gated, failing, not_run, reviewed, unrunnable, dangling, unproven; selhávající test z toho dělá failing, jinak je to nejslabší z testů, které mohou nést důkaz; uvedený důkaz, který neexistuje, je dangling a způsobí selhání kontroly rule-proof | majordomus-cli rules show <id>, GET /api/v1/rules/rule | | záruka | veřejné prohlášení o tom, co nástroj dělá, s jeho zdrojem, implementací, testem a stavem, publikované na webu; soubor každé z nich nazývá tvrzení | docs/CLAIMS.yaml, docs/claims/, /guarantees/ | | důkazy | zaznamenané provedení testu: runner, výsledek, commit, stav pracovního stromu, digest a původ, nejnovější pro každý test; jeho stav vůči stromu, na který se ptáme, se odvozuje a nikdy neukládá | .ai/repo/evidence/ledger.json, majordomus-cli evidence record, evidence show | | stav důkazu | co důkazy záruky říkají o tomto stromu: proven (od běhu se nic nezměnilo), inputs_unchanged (něco se změnilo, ne jeho vlastní vstupy), stale (jeho vstupy se změnily), failing, not_run, unrunnable, no_test; čerstvost je vztah ke stromu, ne časové razítko | majordomus-cli evidence claim <id> | | kontrola | kontrola vlastněná repozitářem s třídami cest, které ji vybírají; kontrola, která pro změnu nikdy nehlásila, je queued, nikdy ne úspěch | .ai/repo/ci/gates.yaml, vypisuje check | | povinnost | něco, co úloha slibuje prokázat (tests, docs, generated, commit, pages, …), deklarované v start a vyžadované finish; některé se zjišťují z gitu nebo z publikovaného webu, ne zaznamenávají | start --requires, share/obligations.yaml | | milník / úkol | specifikace výsledku a prováděcí kontrakt: závislosti, rozsah, akceptační kritéria, požadované důkazy a časová razítka přechodů — a žádné pole stavu | .ai/repo/project/milestones/, .ai/repo/project/issues/ | | odvozený stav | DONE, VERIFY, ACTIVE, BLOCKED nebo READY úkolu, vypočtené z jeho časových razítek, závislostí a toho, zda jsou jeho požadované důkazy pokryty; stav předbíhající své blokátory se hlásí | majordomus plan status | | prováděcí vlna | vrstva Kahnova algoritmu úkolu v grafu závislostí; připravené úkoly v jedné vlně, které sdílejí cesty, jsou konflikt rozsahu, protože závislosti říkají, co by mohlo běžet společně, a rozsah říká, co bezpečně může | majordomus plan waves | | topologie worktree | kanonická cesta checkoutu větve, <repository>-wt/<branch>, odvozená z jejího názvu a nikdy neregistrovaná; commit z feature větve odjinud se odmítne | majordomus-cli worktree status, pre-commit hák | | sdílený server | jeden server, který checkout provozuje pro všechny klienty, zvolený přes lease; obsluhuje MCP, HTTP, OpenAPI, Swagger UI a Cockpit | majordomus-cli serve status, .ai/local/state/mcp/server.json | | peer | jeden připojený klient MCP na nástěnce checkoutu: id pozice (p1), název klienta, transport a jeho ohlášení; checkout, který nese, je trvalá polovina jeho identity | majordomus_peers, GET /api/v1/peers | | ohlášení | uvedený záměr a rozsah peera, volitelně pod jménem; nahrazuje se novým ohlášením pod stejným jménem, drží se jen v paměti serveru | majordomus_announce | | překryv | dva rozsahy, které jsou si rovné nebo jeden obsahuje druhý na hranici cesty, hlášené mezi ohlášeními a mezi aktivními úlohami; povědomí, nikdy zámek | majordomus_peers, start, check --overlap, context | | uzel meshe | instance Majordomu identifikovaná klíčem Ed25519, viděná přes multicast, broadcast nebo rendezvous endpoint s TTL přítomnosti; pozorovaná, nikdy autoritativní, ve výchozím stavu vypnutá | majordomus-cli mesh status, .ai/repo/mesh/majordomus.yaml | | prostředí repozitáře | jeden typovaný snímek toho, čím checkout je — projekt, správa verzí, toolchainy, vrstva, workflow, poskytovatelé, služby, diagnostika — s proveniencí každé hodnoty; banner shellu je jeden jeho renderer | majordomus-cli env, GET /api/v1/environment | | efekt | co běh schopnosti mění: read, process_state nebo repository_mutation; poslední je vždy příkaz dosažený přes POST, uvedený v instrukcích MCP a v x-majordomus-effect OpenAPI | docs/generated/registry.json | | funkce | produktová schopnost jako objekt vrstvy, jmenující moduly, příkazy, druhy, pravidla, tvrzení a případy užití, ze kterých se skládá; stránky funkcí webu a matice rozhraní se z ní odvozují | .ai/repo/features/, majordomus-cli product matrix | | doména | jedna z mála věcí, které produkt ovládá, jako objekt vrstvy se svým příslibem a selháním, na které odpovídá; funkce jmenuje právě jednu a členy domény, povrchy a důkazy se odvozují z funkcí, které ji jmenují | .ai/repo/features/domains/, majordomus-cli product domains | | záměr | co se musí stát pravdou, jako typovaný záznam nad milníky, které jej realizují; jeho fáze se odvozuje z plánu, každé kritérium splňují jen aktuální důkazy, úkol jmenuje kritérium, kterému slouží, a uzavřená práce, které důkazy odporují, se odmítne | majordomus intent list, intent validate, intent realization, /cockpit/intents, .ai/repo/project/intents/ |
Čtyři druhy stavu
Každá hodnota, kterou nástroj ukazuje, je jedním z těchto druhů, a druh rozhoduje, kdo ji smí zapsat a co ji smí přepsat.
| Druh | Co to je | Příklady | Smí přepsat kanonický stav? |
|---|---|---|---|
| kanonické | napsal člověk nebo pracovník v commitu | pravidlo, ADR, politika, závislosti úkolu, deklarace schopnosti | — |
| odvozeno | počítáno deterministicky z kanonických a pozorovaných vstupů, nikdy se needituje | stav úkolů, vlny, důkaz pravidla, stav důkazu, docs/generated/ | ne: přegenerováno a ruční úprava selže při kontrole driftu |
| pozorováno | změřeno nyní, pravdivé jen v okamžiku svého časového razítka | HEAD, špinavý strom, připojení peeři, přítomnost uzlu meshe, zda služba odpovídá | ne: vyprší |
| odhadnuto | nejlepší odhad heuristiky | relevance klíčových slov v seřazené pracovní množině | ne: omezeno pod každý deklarovaný vztah |
Co každý koncept ušetří
Pojmy existují, protože každý nahrazuje něco, co by worker jinak musel dělat znovu v každé relaci. Úspora je ušetřená opakovaná práce, ne úložiště.
| Koncept | Čeho to každého pozdějšího workera ušetří | Co komprimuje | Psaný ručně, nebo odvozený |
|---|---|---|---|
| pravidlo | opakované sdělování téhož omezení a jeho kontrola od oka | odstavec instrukcí na identitu s režimem vynucování | napsáno jednou |
| doktrína | znovuobjevování, proč skupina pravidel existuje, a ruční spouštění jejich kontrol | princip plus validátor, který o něm rozhoduje | napsáno jednou |
| ADR | znovu rozhodování architektonické otázky | debata na rozhodnutí, alternativy a důsledky | ručně psáno, přijato člověkem |
| rozhodnutí | opětovné položení menší, už vyřešené otázky | jeden řádek: co, proč a co bylo zamítnuto | ručně psané |
| kontextový dokument | čtení každé instrukce, aby se našly ty pro tyto cesty | pokyny, které platí pro jednu cestu | autorské, řešené po cestách |
| sestavený kontext | rekonstrukce projektu z historie | git, úloha, pravidla, rozhodnutí a poslední předávka do jednoho rozpočtovaného dokumentu | odvozeno na relaci |
| kontrolní bod | ztráta poslední hodiny, když relace zemře | nedávný pokrok do omezené poznámky | psané, nebo odvozené |
| handover | přehrání přepisu | relace rozdělená na cíl, stav a další akci, s jejím commitem | tělo psané, identita odvozená |
| úkol a vlny | zjišťování, co může běžet dál | graf závislostí na připravené množiny a bezpečné paralelní vrstvy | autorské záznamy, odvozený stav |
| rozsah a překryv | objevení kolize při merge | kdo si nárokuje které cesty | rozsah je psaný, překryv odvozený |
| evidence | znovu zjišťovat, zda bylo něco testováno proti tomuto kódu | běh na výsledek a commit | zaznamenáno, stav odvozen |
| kontrakt příkazu finish | posuzovatel kontrolující vše ručně | podmínky „hotovo“ na řádky, které projdou nebo neprojdou | politika autorská, verdikt odvozený |
| jedna deklarace schopnosti | aktualizace CLI, API, MCP, Cockpitu a dokumentace zvlášť | jedna operace do každého rozhraní | napsáno jednou, projekce odvozeny |
Kolik každé z nich ušetří, lze změřit, ale nic z toho zde změřeno není. Vyžadovalo by to měření porovnávající workery na téže úloze s tímto záznamem a bez něj: čas do první správné změny, velikost vstupu, opravné prompty, opakovaná čtení souborů a kvalitu výsledku. Číslo patří do této tabulky teprve poté, co to proběhlo a bylo zaznamenáno.
Slova se dvěma významy
V tomto repozitáři se dvě slova používají pro dvě různé věci a každé zůstává, protože jeho přejmenování by rozbilo publikované identity.
- tvrzení znamená překrývající se rozsah viděný z jiného worktree (řádek výše) a také položku
docs/CLAIMS.yaml, veřejnou záruku. Na webu se druhé vždy nazývá záruka. - projekce znamená instrukční soubor poskytovatele vykreslený z politiky (řádek výše) a obecněji jakýkoli povrch odvozený z kanonické deklarace: trasy HTTP, dokument OpenAPI, nástroje MCP a generovaná reference jsou projekce registru schopností.
Dva výsledky, které lidé zaměňují
no_match znamená, že práce byla vykonána a hledaná věc neexistuje. failed znamená, že práci nebylo možné vykonat.
„Hledali jsme a nic nenašli“ a „zdroj nešlo prohledat“ vypadají v přepisu stejně. Dohled, který je nedokáže rozlišit, nemůže rozhodnout, zda zkusit znovu, eskalovat, nebo přijmout. Rozhoduje typované pole; próza nikdy.
Dvě slova, která jsou jedno slovo
úloha je aktivní jednotka práce v checkoutu a nic jiného. Schopnost, která trvá dost dlouho na to, aby ji šlo sledovat, není „úloha“: je to schopnost, jejíž handler hlásí průběh a zastaví se, když o to je požádán, a jedno její volání je provádění. Slovo bylo k dispozici a nevzalo se, protože slovník s jedním slovem pro dvě věci je přesně to, čemu tato tabulka existuje, aby zabránila.
Co záměrně není koncept
Žádný agent, persona, role, úroveň ani registr či katalog pracovníků. Dozorový nástroj, který přidává podstatná jména, se stává tím, co dozoruje. Jediný aktér, kterého Majordomus zná, je owner, volný řetězec v záznamu úlohy. Registr schopností spustitelného souboru v Rustu indexuje vlastní povrch nástroje, nikdy pracovníka, a při každém startu se odvozuje z vrstvy a z kódu.
Úloha, relace, předávka: tři objekty, tři otázky
Překrývají se v čase a snadno se slijí v jedno, a každé slití ztrácí něco konkrétního.
Úloha odpovídá na na čem se pracuje, za jakých omezení, v jakých cestách. Má rozsah, má profil a přežije workera: úloha zahájená v úterý může být ve čtvrtek pokračována někým jiným.
Relace odpovídá na co udělal jeden worker mezi tím, kdy si sedl, a tím, kdy přestal. Nemá rozsah a nic neomezuje. Může zahrnovat několik úloh a jedna úloha může být zahrnuta několika relacemi. Je to jediný objekt, který umí odpovědět, jaká práce se stala společně a v jakém pořadí.
Předávka odpovídá na co další člověk potřebuje, aby v této práci pokračoval. Je autorská, záměrná, vzácná a má povinné sekce.
Sbalte relaci do úlohy a ztratíte epizodu: dvě rozhodnutí zaznamenaná s hodinovým odstupem pod různými úlohami vypadají nesouvisle, protože nic nezaznamenává, že obě udělal jeden worker při jednom sezení. Sbalte relaci do předávky a dostanete přepis — vyprávění o epizodě místo množiny odkazů na to, co vytvořila, což je selhání, jemuž se celý tento návrh snaží vyhnout. Sbalte úlohu do relace a rozsah ztratí smysl, protože epizoda žádný nemá.
Dva záznamy, které si lidé pletou
checkpoint a handover vypadají podobně — oba jsou append-only Markdown s vypočtenou front matter — a pokládat je za jednu věc vás stojí obojí.
Checkpoint se zapisuje často a čte celý. Říká v několika řádcích, co platilo před několika minutami a co přijde dál, aby ho další briefing mohl citovat doslova. Politika omezuje jeho délku a tělo nad limitem se odmítne, ne zkrátí.
Předávka se píše zřídka a čte záměrně. Má povinné sekce, odmítne se, je-li kterákoli prázdná, a je to balíček, z něhož jiný worker pokračuje.
Strop je to, co je udržuje odlišné. Bez něj checkpointy vyrostou v reporty, reporty jsou příliš dlouhé, aby šly do briefingu, a briefing se zdegraduje na ukazatel — což je místo, odkud nástroj začínal, než kterýkoli záznam existoval.
Nepřítomnost je pojem
No relevant handover. je odpověď, ne selhání. Řešení bere v úvahu stejný worktree a větev, pak stejnou větev, a tam končí. Záznam z nesouvisející větve se nikdy nenabízí, protože worker nepozná, že vypůjčený kontext je špatný, dokud podle něj nejednal. Absence je lepší než nesprávná paměť.
Co záměrně stále není pojem
Žádný agent, persona, role, úroveň, registr ani katalog promptů. prompts/ drží několik znovupoužitelných rámování, ne knihovnu; nic je neřadí a nic žádné nenačítá, pokud se o to nežádá. Žádný sumarizátor, embedding, vektorové úložiště, přepis. Majordomus ukládá, validuje, řeší, promítá a ověřuje. Nikdy nevolá model.