Případy užití
Co s tím lidé dělají: úloha, příkazy, které na ni odpovídají, a co vám zůstane v rukou, vše dokázáno proti nástroji. Každý krok je skutečné volání, každé pravidlo a příslib skutečný objekt a každý příklad níže byl spuštěn, aby vznikla tato stránka.
- případy užití
- 49
- kategorie
- 10
- spustitelný soubor
- 2
- zaručeno
- 45
- ověřeno
- 2
- coverage
- 148 z 351 cílů
Filtrování běží v prohlížeči. Bez JavaScriptu je každý případ užití níže stále uveden, po kategoriích.
Začínáme a převzetí 5
Zavedení Majordoma do repozitáře, nového či starého, aniž by se ztratilo, co lidé už napsali.
-
zaručeno základní
Převezměte repozitář, který už má vlastní pravidla
Nainstalujte dozorovou vrstvu do repozitáře s ručně psaným CLAUDE.md, aniž by si nástroj přivlastnil soubor, který napsal někdo jiný.
init · update · doctor -
zaručeno základní
Nainstalujte nástroj jedním příkazem na stroji bez toolchainu
Vložte jeden řádek, získejte ověřenou binárku pro tento stroj a spusťte majordomus init — bez gitu, Rustu, Node, Pythonu, rootu a bez možnosti nainstalovat archiv, jehož otisk nesouhlasí.
version · init · doctor -
zaručeno základní
Před důvěrou v diagnózu zkontrolujte verzi
Vytiskne verzi, kterou odvozují všechny ostatní plochy, a ukáže argument, který odmítne.
verze -
zaručeno základní
Přesuňte repozitář z rozložení před .ai na vrstvu
Podívejte se, co by migrace přesunula, přesuňte to se zálohou a dokažte, že výsledek je vrstva, kterou nástroj čte.
migrate · doctor -
zaručeno základní
Používejte nástroj jako vlastní ve sdíleném repozitáři a navrhněte ho týmu, až obhájí svůj přínos
Jeden přepínač nainstaluje stejnou vrstvu jen pro vás: žádný sledovaný soubor se nezmění, do .gitignore se nic nepřidá, git status vypadá stejně — příkaz to ověří — a jeden další příkaz vrstvu předá týmu.
init · update · doctor
Relace a předávka 11
Zastavování a obnovování práce napříč relacemi a workery z trvalého stavu, nikdy z přepisu.
-
zaručeno základní
Uchovat prompty, které práci zahájily, pod modelem, ne kolem něj
Zapojte hook providera, dokažte jej protažením payloadu a ověřte, že prompt, který nástroj nedokázal parsovat, se ohlásí, a ne tiše zahodí.
záznam -
zaručeno pokročilý
Předat práci s otevřenou otázkou a nechat ji dál blokovat
Uzavřete úlohu do předávky, zatímco je otázka nevyřešená, spusťte navazující úlohu a podívejte se, že tatáž otázka tam stále odmítá přijetí.
handover · start · check · question · finish -
zaručeno základní
Dělat u dlouhé práce kontrolní body, aby zastavení stálo minuty, ne celý den
Zaznamenávejte stručný postup uvnitř aktivní úlohy v intervalu profilu, aby relace, která skončí bez varování, nechala další místo, kde začít.
checkpoint · check · context -
ověřeno základní
Předat nedokončenou práci další relaci
Zastavte uprostřed úlohy a zanechte dalšímu workerovi něco, s čím lze jednat a co není přepis.
checkpoint · předávka · kontext · kontrola -
zaručeno základní
Zaznamenat rozhodnutí, aby ho další pracovník našel
Zapište, co bylo rozhodnuto a proč, jako stav, a pak to znovu najděte, aniž byste četli konverzaci.
decision · search · history -
zaručeno základní
Nechat relaci otevřít a uzavřít, aniž by si na to kdokoli musel vzpomenout
Zapojte vlastní události relace poskytovatele a epizoda se otevře, když sezení začne, předá pracovníkovi, co zanechalo to poslední, zaznamená, co se chystá zahodit komprimace, a uzavře se záznamem pokračování vedle své obálky.
capture · session · doctor · start · checkpoint · handover -
zaručeno základní
Zaznamenat, co jeden pracovník udělal v jednom sezení
Otevřete relaci, odvádějte práci v rámci úloh, kterých se dotkne, a uzavřete ji do obálky, která odkazuje na to, co vytvořila, a nic nekopíruje.
relace · historie · znalosti -
zaručeno pokročilý
Číst jen kontext, který se vejde do rozpočtu, a vědět, co bylo vynecháno
Sestavte kontext, který worker potřebuje teď, v pořadí podle autority, oříznete ho na rozpočet řádků a uvidíte každou vypuštěnou sekci pojmenovanou i s důvodem.
context · check -
zaručeno pokročilý
Uzavřít epizodu, jejíž klient se nikdy nevrátil
Zabitý provider neposílá událost konce. Uzavřete epizodu, kterou zanechal otevřenou, na základě důkazů, právě jednou, bez nárokování práce, kterou neodvedl.
recover -
ověřeno základní
Zahájit relaci z vykresleného zarámování, ne z vloženého přepisu
Vypište prompt assety, které repozitář dodává, vykreslete jeden proti trvalému stavu a přečtěte si kontext, který vkládá.
prompt · kontext -
zaručeno pokročilý
Pokračovat ve správném worktree, nikdy proti cizí úloze
Najděte předávku, která patří k tomuto worktree a větvi, a podívejte se, jak se záznam úlohy z jiného checkoutu hlásí jako cizí, místo aby se tu vynucoval.
handover · check · context
Paralelní workery 3
Několik agentů nebo lidí v jednom repozitáři: nárokované rozsahy, překryv a kdo čeho se dotkl.
-
zaručeno pokročilý
Dodávejte úkoly ve vlnách, které spočítá graf, a berte další
Zvalidujte plán, přečtěte vlny provádění, které graf závislostí dává, podívejte se, které úkoly jsou připravené a které na čem blokované, a vezměte jeden úkol, který má worker udělat teď.
plan · start -
zaručeno pokročilý
Provozujte více workerů v jednom repozitáři, aniž by se srazili
Dejte každému workerovi deklarovaný rozsah a zjistěte okamžitě, když dva z nich nárokují stejné cesty.
start · check · finish -
zaručeno pokročilý
Pracujte na větvi v jediném worktree, které jí patří
Založte větev, aniž byste volili cestu, najděte z kteréhokoli checkoutu všechny checkouty repozitáře a přiveďte zatoulaný domů s nedotčenou necommitnutou prací.
doctor · kontext
Politika a vynucování 5
Deklarování pravidel, prokazování, že jsou zapojená, a reprodukce nálezu.
-
zaručeno základní
Podmiňte CI samotným nástrojem, s návratovým kódem, který je smlouvou
Spouštějte kontroly, které spouští CI, čtěte každý nález s příkazem, který ho reprodukuje, a spoléhejte na návratové kódy, z nichž každý znamená jedinou věc: žádný kód neznamená varovat a pokračovat.
doctor · watch · doktrína · kontrola -
spustitelné pokročilý
Rozdělte pracovní strom na commity a každou zprávu poměřte s politikou
Zeptejte se, co by tento strom commitnul a proč, naučte se slovník rozsahů z historie místo z tabulky a získejte verdikt k jedné zprávě nebo k celému rozsahu dřív, než ho musí dát recenzent.
doktrína -
zaručeno pokročilý
Dokažte, že se pravidlo skutečně vynucuje, a nejen že je napsané
Odpovědět na „je toto pravidlo skutečné?“ příkazem, ne čtením zdroje.
doktrína · doctor · kontrola -
zaručeno základní
Zjistěte, která pravidla tu platí a co je vynucuje
Vypište efektivní sadu pravidel, přečtěte jedno pravidlo tak, jak ho čte nástroj, a zjistěte, která z nich nástroj vynucuje a odkud.
rules · doctrine -
zaručeno základní
Politice a profilům důvěřujte, až když jsou ověřené
Dokažte, že kanonická politika se parsuje se všemi potřebnými klíči, že se parsuje každý profil a existuje výchozí, a že to, co politika deklaruje jako vynucené, je to, co skutečně běží.
doctor · check
Kontroly dokončení a kvality 7
Rozhodování, zda je práce hotová, se smlouvou, jejíž každý řádek buď projde, nebo selže.
-
zaručeno pokročilý
Rozhodnout, zda je dokončená práce skutečně dokončená
Vyhodnoťte smlouvu řádek po řádku, místo abyste přijali větu, která říká, že práce je hotová.
finish · question · check -
zaručeno pokročilý
Zablokovat přijetí kvůli otázce, na kterou nikdo neodpověděl
Otevřete k úloze otázku, sledujte, jak finish odmítne dokončení, dokud není vyřešená, vyřešte ji odpovědí a teprve pak dokončete.
question · finish · check -
zaručeno základní
Přichytit agenta, který tvrdí, že je hotov, a není
Jedna úloha od začátku do konce: pracovník vybočí ze svého rozsahu, tvrdí, že je hotov, předá a je přijat teprve tehdy, když projde vlastní ověření repozitáře.
start · check · finish · handover · context -
zaručeno pokročilý
Dokončit úkol, jen pokud existují jeho důkazy
Podívejte se, jak úkol odmítne dokončení, dokud chybí požadovaný důkaz, přečtěte plán rozvoje, který odvozuje stav milníku, a udržte projekci na GitHubu jen projekcí.
plan -
spustitelné základní
Vědět, zda je práce v tomto checkoutu dokončená
Zeptejte se repozitáře, ve kterém stojíte, a nechte si jmenovitě říct, co zbývá dodat.
check · watch -
zaručeno základní
Dokázat, co úloha dlužila, než ji prohlásíme za hotovou
Úloha deklaruje, co dluží, zaznamenává důkaz ke každému závazku a je odmítnuta, jakmile tento důkaz už nepopisuje strom, nad nímž vznikl.
start · evidence · check · finish -
zaručeno základní
Říct, co se dostalo na remote a co ne
Závazky, které sahají za pracovní strom, se vyřizují dotazem na git a publikovaný web, takže hlášení nemůže označit necommitnutou práci za commitnutou ani nepushnutou za pushnutou.
evidence · check · finish
Drift a rekonciliace 2
Zjišťování, že se politika, projekce, stav a git rozcházejí, a uvádění do souladu.
-
zaručeno základní
Zjistěte, co se změnilo od doby, kdy se někdo naposledy díval
Ptejte se, co se pohnulo, místo zda je něco špatně.
watch · update · history -
zaručeno základní
Udržujte bootstrap každého providera tenký, generovaný a v rámci rozpočtu
Přegenerujte AGENTS.md, CLAUDE.md a další soubory providerů z jedné politiky a dokažte, že jsou orazítkované, odkazují na vrstvu, drží se pod rozpočtem řádků a vyřeší každý odkaz.
update · doctor · watch
Znalosti repozitáře 8
Co repozitář deklaruje o sobě: zdroje, uzly, hrany, plán a jejich vyhledávání.
-
zaručeno pokročilý
Určit jako data, co patří do AI kontextu
Přečtěte deklarovanou politiku rozsahu repozitáře, zjistěte, které cesty jsou v indexu a které mimo něj, a nechte doctor a znalostní index aplikovat ji místo pevně zakódovaného seznamu.
knowledge · doctor -
zaručeno pokročilý
Odmítnout adresář vrstvy, který nic nedokumentuje
Adresář přidaný pod vrstvu bez kontextového dokumentu neprojde validací, a to jmenovitě; nic se nevyřeší proti stromu, dokud neřekne, k čemu je, a tatáž hierarchie je čitelná přes MCP i API bez spuštění kontroly.
context · doctor -
zaručeno základní
Předat repozitář někomu, kdo ho nemůže naklonovat
Pořiďte snímek, který model přečte nebo kontrola v něm může běžet, bez odesílání čehokoli nesledovaného a bez ztráty režimů souborů cestou.
archiv -
zaručeno základní
Uchovat, co se epizoda naučila, bez modelu a bez konverzace
Zaznamenejte rozhodnutí uvnitř epizody, odvoďte ho z ledgeru do kandidátského záznamu znalostí, přečtěte důkaz, že odvození proběhlo, a sledujte, jak druhé odvození nic nezmění.
start · decision · knowledge · history -
zaručeno pokročilý
Vést plán jako milníky a úkoly, které nástroj umí validovat
Deklarujte milníky jako výsledky a úkoly jako prováděcí smlouvy a nechte nástroj říct, co je připravené a co blokované.
plan -
zaručeno základní
Přečíst zpětně, co se stalo, a držet knihu záznamů v limitu
Čtěte ledger určený jen k připojování jako provozní historii, filtrovanou podle úlohy a události, zvalidujte každý řádek a nejstarší řádky přesouvejte do archivu místo jejich mazání.
historie · hledání · watch -
zaručeno základní
Zaznamenat rozhodnutí jako data a dokázat, že ho nástroj nemůže přijmout za vás
Přečtěte rozhodnutí, která repozitář obsahuje, zvalidujte celou sadu jedním příkazem a sledujte, jak nástroj odmítne zapsat jediný stav, který smí zapsat jen člověk.
adr · knowledge -
zaručeno pokročilý
Dohledat ke změně kontextové dokumenty, kterých se týká
Vypište dokumenty s rozsahem kontextu, zjistěte, které platí pro cestu a proč, a před přistáním zjistěte, kterých dokumentů se sada změn dotýká.
context · doctor
Poskytování vrstvy AI klientům 3
Jeden sdílený server na repozitář, každý klient je peer, tatáž vrstva přes MCP, HTTP i příkazovou řádku.
-
zaručeno základní
Najděte objekt vrstvy, aniž byste četli všechno
Prohledávejte trvalé záznamy doslovně napříč druhy z shellu a stejnou otázku položte sdílenému serveru přes MCP pomocí majordomus_search a majordomus_get.
search · knowledge · prompt -
zaručeno základní
Podívejte se, co repozitář obsahuje, a spusťte jednu z jeho schopností, aniž byste četli soubor
Otevř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.
doctor · knowledge -
zaručeno základní
Servírujte AI vrstvu repozitáře všem AI klientům jedním sdíleným serverem
Otevřete repozitář v libovolném klientovi, pro nějž nástroj deklaruje providera (docs/generated/providers.md), a nechte každého z nich číst tutéž pravidla, prompty a znalosti přes MCP z jednoho procesu, přičemž se navzájem vidí.
init · doctor
Výkon 1
Měření výkonu odvozená z registru, základní hodnoty jako data a rozpočty, vůči nimž doctor hlásí.
Rozšíření 4
Přidání druhu, pravidla, příkazu nebo případu užití jako dat, s kontrolami, které z toho vyplývají.
-
zaručeno pokročilý
Přidejte případ užití a nechte ho nástrojem dokázat
Vytvořte scaffold návrhu pro nepokrytý příkaz, zvalidujte ho, spusťte jeho scénář proti skutečnému nástroji a sledujte, jak se pokrytí posune.
usecase · doctor -
zaručeno pokročilé
Rozšiřte, co spustitelný soubor servíruje, přidáním souboru, nikdy jeho přebuilděním
Přidejte do .ai/ pravidlo, prompt nebo uzel znalostí a nechte ho objevit se jako zdroj MCP, trasa HTTP a položka reference, toutéž binárkou.
init · update · doctor · knowledge -
zaručeno základní
Postupujte podle procedury, kterou repozitář definuje, a přidejte další
Přečtěte dovednosti repozitáře, převezmě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á řekne, co prověřila.
skills -
zaručeno pokročilý
Řekněte jednou, k čemu je vaše práce, a ať to říká každá plocha
Zaznamenejte provozní režim selhání jako jeden soubor a nechte na něj odpovídat příkazovou řádku, API, MCP i web, aniž byste ho někde registrovali.
init · kontext · znalosti · doctor
Co je zde případ užití
Jeden soubor v .ai/repo/use-cases/: příkazy, pravidla a sliby, které pojmenovává, a scénář, který nástroj spouští proti sobě samému. Zralost zobrazená na každé kartě je pozorovaná, ne napsaná: případ užití je guaranteed, jen když jeho scénář prošel a každé tvrzení, které pojmenovává, je zaručeno. Stránka pokrytí říká, které schopnosti stále nemají případ užití.
Stránka why je okamžik, který poznáte. Případ užití je úloha, kterou provádíte. Aplikace je kontext, kterému vyhovuje. Stránka příkazu je povrch jednoho příkazu.