•ověřeno
Relace a předávkazákladníagentjen pro čtení
Každá nová relace začíná stejným odstavcem, který někdo píše z paměti, a stav repozitáře, který popisuje, je to, co si ten člověk naposledy pamatoval.
setup: installed
given:
- 'Majordomus installed; the skeleton ships its prompt assets'
steps:
- id: which
run: ['prompt', 'list']
note: 'the small set of versioned framings; nothing ranks them'
expect:
exit: 0
stdout_contains: ['continue', 'handover', 'review']
- id: refuse-unknown
run: ['prompt', 'show', 'nosuch']
note: 'an asset that does not exist is named with the command that lists them'
expect:
exit: 12
stdout_contains: ['no prompt asset', 'prompt list']
- id: the-context
run: ['context']
note: 'what a prompt embeds: durable state in authority order, within the budget'
expect:
exit: 0
stdout_contains: ['^## GIT', '^## BUDGET']
then:
- 'a prompt is rendered against a closed set of state tokens'
- 'the context inside it is the same one `context` prints'
Rámec je verzovaný soubor pod .ai/repo/prompts/; jeho vykreslení vloží sestavený kontext, takže relace začíná z trvalého stavu a rozpočtu, ne ze vloženého textu.
Scénář
Provedeno proti skutečnému nástroji v repozitáři připraveném pomocí installed, při každém generování tohoto webu. To, co následuje, není popis toho, co by se mělo stát; je to to, co se stalo.
dáno
- ·Majordomus nainstalován; kostra dodává své prompt assety
kdy
- 1
majordomus prompt list - 2
majordomus prompt show nosuch - 3
majordomus context
pak
- ·prompt se vykresluje proti uzavřené sadě stavových tokenů
- ·kontext uvnitř je tentýž, který vypisuje `context`
Co nástroj udělal
Důkaz běhu, z něhož byla tato stránka vygenerována: pass, 3 kroky. Výstup je normalizován: cesta k repozitáři, časová razítka, id a doby trvání jsou zástupné hodnoty; nic dalšího se neupravuje.
Testováno v test/cases/94_use_cases.sh, který spouští každý scénář a odmítne krok, jehož zaznamenaný výstup není tím, co vyprodukoval.
-
malá množina verzovaných zarámování; nic je neřadí
continue resume a task from durable state instead of from someone's memory
debug frame a defect so that the fix is proven, not asserted
handover produce a continuation record body for the current task
review review the working diff against the claimed scope and the finish contract
- exit 0
- stdout_contains /continue/
- stdout_contains /handover/
- stdout_contains /review/
-
neexistující asset je pojmenován s příkazem, který je vypisuje
majordomus: no prompt asset 'nosuch' (.ai/repo/prompts/nosuch.md); try: majordomus prompt list
- ukončení 12
- stdout_contains /no prompt asset/
- stdout_contains /prompt list/
-
co prompt vkládá: trvalý stav v pořadí autority, v rámci rozpočtu
# Majordomus context — <time>
# a projection of durable state, not a source of truth: validate every line against git
## GIT
repository <repo>
branch main
head <sha>
working_tree clean
## TASK
none active — run: majordomus start "<task>" --scope <paths>
## KNOWLEDGE (candidates awaiting review on this branch; majordomus knowledge candidates)
No knowledge candidates await review on this branch. That is an answer, not a gap: `majordomus knowledge candidates` lists every branch.
## EXCLUDED
- context documents — no active task names a scope; run: majordomus context resolve <path>
- handover — no record for this worktree and branch — absence, not a stale match
## BUDGET
21 of 300 lines
- exit 0
- stdout_contains /^## GIT/
- stdout_contains /^## BUDGET/
Proč to nástroj ví
Řetězec od této stránky ke kódu: případ užití jmenuje příkazy, pravidla a tvrzení; každé pravidlo se dispatchuje z registru a každé tvrzení jmenuje test, který ho dokazuje; scénář výše provedl příkazy. Nic v tomto řetězci není text o záměru.
Pravidla, díky nimž platí
Uplatněné záruky
Související případy užití
Vypočteno z toho, co sdílejí: tvrzení, pravidla, příkazy, kategorie, aplikace. Tento seznam nikdo neudržuje.
- Předat nedokončenou práci další relaciZastavte se uprostřed úlohy a zanechte dalšímu pracovníkovi něco, na co lze navázat a co není přepis.
- Čtěte jen kontext, který se vejde do rozpočtu, a vězte, co se zahodiloSestavte kontext, který worker potřebuje právě teď, v pořadí autority, oříznuté na rozpočet řádků, a podívejte se na každou zahozenou sekci jmenovanou s důvodem.
- Najděte objekt vrstvy, aniž byste četli všeHledejte 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.
- Dělat checkpointy dlouhé práce, aby zastavení stálo minuty, ne celý denZaznamenávat kompaktní postup uvnitř aktivní úlohy v intervalu profilu, aby relace, která skončí bez varování, nechala další relaci místo, kde začít.
- Navažte ve správném worktree, nikdy proti cizí úlozeNajděte předávku, která patří tomuto worktree a větvi, a podívejte se, jak se záznam úlohy z jiného checkoutu ohlásí jako cizí, místo aby se tady vynucoval.