Mapa programu

Každý modul CLI, každý soubor, který čte a zapisuje, naskenované ze shellových zdrojů, ne nakreslené ručně.

Tohle nikdo nenakreslil. scripts/lib/architecture-scan.awk reads bin/majordomus and lib/*.sh při každém buildu a hlásí, co dokáže prokázat: který modul zdrojuje který a který soubor pod .ai/ každý modul jmenuje. Modul, který přestane na soubor sahat, o svou hranu přijde týž den. Diagram, který nemůže zastarat, má větší cenu než hezčí, který zastarat může.

Co znamená hrana

Směr vychází z řádku, na kterém reference stojí — z přesměrování, za nímž je, nebo ze slova příkazu, které ji uvádí. Cesta předaná přímo pomocníkovi se kreslí jako uses, nehádá se, protože špatná šipka by tu byla tvrzením, které zdroje nepodporují. Chcete-li přesné pravidlo, přečtěte si skener; má čtyřicet řádků.

statický sken odkazů v bin/majordomus a lib/*.sh

čte zdroje používá zapisuje

Vyberte uzel, abyste viděli, co to je a čeho se dotýká.

Moduly CLI a soubory v .ai/, kterých se dotýkají. Plné šipky jsou čtení a zápisy, které skenování dokázalo umístit; přerušované šipky jsou odkazy, u nichž by si směr netroufalo tvrdit.

Stejný graf jako text — 92 uzlů, 279 hran

majordomus vstup
- sources lib/adr.sh
- sources lib/archive.sh
- sources lib/bench.sh
- sources lib/capture.sh
- sources lib/check.sh
- sources lib/checkpoint.sh
- sources lib/common.sh
- sources lib/context.sh
- sources lib/decision.sh
- sources lib/doctor.sh
- sources lib/doctrine.sh
- sources lib/evidence.sh
- sources lib/finish.sh
- sources lib/handover.sh
- sources lib/history.sh
- sources lib/init.sh
- sources lib/knowledge.sh
- sources lib/migrate.sh
- sources lib/plan.sh
- sources lib/prompt.sh
- sources lib/question.sh
- sources lib/recover.sh
- sources lib/rules.sh
- sources lib/search.sh
- sources lib/session.sh
- sources lib/skills.sh
- sources lib/start.sh
- sources lib/update.sh
- sources lib/usecase.sh
- sources lib/watch.sh
běžné modul
- reads .ai/manifest.yaml
- reads .ai/repo/policy.yaml
- reads .ai/repo/providers
- sources lib/capture.sh
- sources lib/changed.sh
- sources lib/rust_bin.sh
- uses .ai/local/state/session-current.yaml
- uses .ai/local/state/sessions-open
- writes .ai/local/state/current.yaml
- writes .ai/local/state/ledger.jsonl
- writes .ai/local/state/mcp/ensure.log
adr modul
architektonická rozhodnutí repozitáře: list, show, propose, check
- sources lib/context.sh
- sources lib/knowledge.sh
- sources lib/rules.sh
- writes .ai/repo/adrs/.id.lock
knowledge modul
zkompilovaný index nad tím, co tento repozitář uvádí, a záznamy, které z něj odvozuje
- reads .ai/local/state/current.yaml
- reads .ai/local/state/sessions-open
- sources lib/changed.sh
- sources lib/decision.sh
- sources lib/rust_bin.sh
- sources lib/session.sh
- uses .ai/local/state/completed
- uses .ai/local/state/decisions.md
- uses .ai/repo/knowledge/sources.yaml
- uses .ai/repo/policy.yaml
rules modul
účinná sada pravidel: vendorovaný základ plus pravidla projektu (jen ke čtení, kromě vendor update)
- reads .ai/repo/rules/vendor
kontext modul
co další worker potřebuje vědět teď, v rámci rozpočtu
- reads .ai/local/state/decisions.md
- reads .ai/local/state/ledger.jsonl
- reads .ai/local/state/open-questions.md
- reads .ai/repo/project/issues
- sources lib/context_docs.sh
- sources lib/decision.sh
- sources lib/handover.sh
- sources lib/history.sh
- sources lib/intent_binding.sh
- sources lib/knowledge.sh
- sources lib/prompt.sh
- sources lib/rust_bin.sh
- sources lib/session.sh
- uses .ai/local/state/checkpoints
- uses .ai/local/state/handovers
repo/adrs/.id.lock artifact
archiv modul
snímek sledovaného stromu ke čtení nebo kontrole jinde
- reads .ai/repo/archive.yaml
repo/archive.yaml artifact
bench modul
změřit každý veřejný příkaz, studený i teplý, proti základní hodnotě
- sources lib/commands.sh
commands modul
záznam modul
zaznamená surové prompty uživatele z hooku poskytovatele a dokáže to
- sources lib/checkpoint.sh
- sources lib/derive.sh
- sources lib/handover.sh
- sources lib/knowledge.sh
- sources lib/rust_bin.sh
- sources lib/session.sh
- uses .ai/local/session-contexts
- uses .ai/local/state/sessions-open
- uses .ai/repo/policy.yaml
- writes .ai/local/state/mcp/ensure.log
session modul
otevře, prozkoumá a uzavře jednu epizodu provádění
- reads .ai/local/state/ledger.jsonl
- sources lib/changed.sh
- sources lib/derive.sh
- sources lib/knowledge.sh
- sources lib/project.sh
- sources lib/session_context.sh
- uses .ai/local/state/locks/outbox-drain
- uses .ai/local/state/locks/session-pointer
- uses .ai/local/state/session-current.yaml
- uses .ai/local/state/sessions
- uses .ai/local/state/sessions-open
local/state/sessions-open artifact
local/session-contexts artifact
derive modul
- reads .ai/local/state/decisions.md
- reads .ai/local/state/ledger.jsonl
- sources lib/decision.sh
- sources lib/knowledge.sh
- sources lib/question.sh
- sources lib/rust_bin.sh
- sources lib/session.sh
- uses .ai/local/state/checkpoints
- uses .ai/local/state/handovers
rust_bin modul
local/state/mcp/ensure.log artifact
kontrolní bod modul
zaznamená stručný průběh uvnitř aktivní úlohy
- sources lib/derive.sh
- sources lib/handover.sh
- uses .ai/local/state/checkpoints
- writes .ai/local/state/current.yaml
handover modul
zapíše záznam pokračování určený jen k připisování (tělo na stdin)
- sources lib/derive.sh
- sources lib/intent_binding.sh
- uses .ai/local/state/handovers
- writes .ai/local/state/current.yaml
repo/policy.yaml artifact
změněno modul
- reads .ai/repo/scope.yaml
- uses .ai/local/state/checkpoints
- uses .ai/local/state/handovers
repo/scope.yaml artifact
local/state/checkpoints artifact
local/state/handovers artifact
check modul
je aktuální úloha v souladu s politikou, rozsahem a stavem?
- sources lib/changed.sh
- sources lib/commands.sh
- sources lib/decision.sh
- sources lib/doctrine.sh
- sources lib/evidence.sh
- sources lib/gates.sh
- sources lib/knowledge.sh
- sources lib/question.sh
- sources lib/start.sh
- sources lib/usecase.sh
- uses .ai/local/state/checkpoints
- uses .ai/local/state/decisions.md
- uses .ai/local/state/ledger.jsonl
- uses .ai/local/state/open-questions.md
- writes .ai/local/state/current.yaml
doktrína modul
která pravidla se vynucují, čím a zda jsou zapojena
- sources lib/rules.sh
local/state/current.yaml artifact
local/state/open-questions.md artifact
local/state/ledger.jsonl artifact
local/state/decisions.md artifact
start modul
zahájí úlohu s rozsahem pod zvoleným profilem
- sources lib/check.sh
- sources lib/context_docs.sh
- sources lib/handover.sh
- sources lib/intent_binding.sh
- uses .ai/local/state/handovers
- writes .ai/local/state/archive
- writes .ai/local/state/current.yaml
otázka modul
otevírat, řešit a vypisovat otázky, které blokují přijetí
- uses .ai/local/state/open-questions.md
rozhodnutí modul
zaznamenat nebo číst trvalá rozhodnutí
- uses .ai/local/state/decisions.md
usecase modul
spustitelné případy užití: list, show, validate, run, coverage, impact, scaffold
- sources lib/commands.sh
- sources lib/evidence.sh
- sources lib/rules.sh
- writes .ai/local/evidence/live
- writes .ai/local/evidence/use-cases
evidence modul
zaznamenat, že jeden závazek deklarovaný úlohou byl splněn
- reads .ai/local/state/ledger.jsonl
- sources lib/gates.sh
kontroly modul
- sources lib/rust_bin.sh
repo/providers artifact
manifest.yaml artifact
local/state/session-current.yaml artifact
intent_binding modul
- sources lib/rust_bin.sh
history modul
přečte zpět knihu událostí určenou jen k připisování
- writes .ai/local/state/ledger.jsonl
prompt modul
vypíše, zobrazí a vykreslí prompt assety lokální pro repozitář
- reads .ai/local/state/decisions.md
- reads .ai/local/state/open-questions.md
- sources lib/context.sh
- sources lib/decision.sh
- sources lib/handover.sh
- uses .ai/local/state/checkpoints
- uses .ai/local/state/handovers
context_docs modul
- uses .ai/repo/policy.yaml
repo/project/issues artifact
nasazení modul
doctor modul
pouze governance: je tu zapojeno každé deklarované vynucování?
- reads .ai/README.md
- reads .ai/local/state/checkpoints
- reads .ai/local/state/handovers
- reads .ai/local/state/ledger.jsonl
- reads .ai/local/state/sessions-open
- reads .ai/repo/scope.yaml
- sources lib/adr.sh
- sources lib/capture.sh
- sources lib/check.sh
- sources lib/commands.sh
- sources lib/context.sh
- sources lib/decision.sh
- sources lib/deployment.sh
- sources lib/doctrine.sh
- sources lib/project.sh
- sources lib/prompt.sh
- sources lib/question.sh
- sources lib/rust_bin.sh
- sources lib/session.sh
- sources lib/skills.sh
- sources lib/update.sh
- sources lib/usecase.sh
- uses .ai/local/state/open-questions.md
- uses .ai/repo/policy.yaml
- uses .ai/repo/providers
- uses .ai/repo/rules/vendor
skills modul
dovednosti repozitáře: výpis, zobrazení a kontrola
- reads .ai/repo/skills
- sources lib/knowledge.sh
- sources lib/rust_bin.sh
projekt modul
- reads .ai/repo/project/project.yaml
- uses .ai/repo/project/issues
- writes .ai/repo/project/milestones
update modul
přegeneruje projekce poskytovatelů z politiky
- uses .ai/local/state/checkpoints
- uses .ai/local/state/handovers
- uses .ai/repo/providers
- writes .ai/local/prompts
README.md artifact
repo/rules/vendor artifact
finish modul
vyhodnotí kontrakt finish; pokud není splněn, odmítne
- reads .ai/local/state/checkpoints
- sources lib/check.sh
- sources lib/handover.sh
- uses .ai/local/state/decisions.md
- uses .ai/local/state/handovers
- writes .ai/local/state/completed
- writes .ai/local/state/current.yaml
local/state/completed artifact
init modul
vytvoří vrstvu .ai/ v tomto repozitáři (odmítne přepsat)
- reads .ai/local/state/decisions.md
- reads .ai/local/state/open-questions.md
- reads .ai/repo/policy.yaml
- reads .ai/repo/rules/vendor
- reads .ai/repo/scope.yaml
- sources lib/rules.sh
- používá .ai/README.md
- uses .ai/local/cache
- uses .ai/local/session-contexts
- uses .ai/local/state/checkpoints
- uses .ai/repo/README.md
- uses .ai/repo/applications
- uses .ai/repo/deployments}
- uses .ai/repo/features
- uses .ai/repo/knowledge/candidates/README.md
- uses .ai/repo/knowledge/curated/README.md
- uses .ai/repo/profiles/README.md
- uses .ai/repo/project/README.md
- uses .ai/repo/prompts/README.md
- uses .ai/repo/rules/README.md
- uses .ai/repo/rules/project/README.md
- používá .ai/repo/sessions}
- uses .ai/repo/skills
- uses .ai/repo/use-cases
- uses .ai/repo/why
- uses .ai/repo/workflows
- writes .ai/local/prompts
- writes .ai/local/state/handovers
repo/README.md artifact
repo/profiles/README.md artifact
repo/prompts/README.md artifact
repo/rules/README.md artifact
repo/rules/project/README.md artifact
repo/knowledge/curated/README.md artifact
repo/knowledge/candidates/README.md artifact
repo/workflows artifact
repo/skills artifact
repo/use-cases artifact
repo/applications artifact
repo/why artifact
repo/features artifact
repo/sessions} artifact
repo/deployments} artifact
repo/project/README.md artifact
local/prompts artifact
local/cache artifact
repo/knowledge/sources.yaml artifact
machine_lock modul
migrate modul
přesune projektová data z doby před .ai z .majordomus/ do .ai/ (explicitně, se zálohou)
- reads .ai/local/state/decisions.md
- reads .ai/local/state/open-questions.md
- reads .ai/repo/rules/vendor
- sources lib/init.sh
- uses .ai/local/cache
- uses .ai/local/prompts
- uses .ai/local/session-contexts
- uses .ai/local/state/checkpoints
- uses .ai/repo/README.md
- uses .ai/repo/knowledge/curated/README.md
- uses .ai/repo/policy.yaml
- uses .ai/repo/profiles/README.md
- uses .ai/repo/project/README.md
- uses .ai/repo/prompts/README.md
- uses .ai/repo/providers
- uses .ai/repo/rules/README.md
- uses .ai/repo/rules/project/README.md
- uses .ai/repo/scope.yaml
- používá .ai/repo/sessions/README.md
- uses .ai/repo/skills
- uses .ai/repo/templates/README.md
- uses .ai/repo/workflows
- writes .ai/local/state/handovers
repo/sessions/README.md artifact
repo/templates/README.md artifact
plan modul
model milníků a úkolů: validovat, číst a posunout úkol
- sources lib/intent_binding.sh
- sources lib/project.sh
- uses .ai/repo/project/issues
- writes .ai/repo/project/milestones
repo/project/milestones artifact
repo/project/project.yaml artifact
recover modul
vrátit úložiště záznamů tohoto checkoutu do stavu, který popisuje kontrakt
- reads .ai/local/state/ledger.jsonl
- sources lib/rust_bin.sh
- sources lib/session.sh
- uses .ai/local/state/archive
- uses .ai/local/state/checkpoints
- uses .ai/local/state/completed
- uses .ai/local/state/session-current.yaml
- uses .ai/local/state/sessions-open
local/state/archive artifact
hledání modul
najde trvalé záznamy, aniž by se četly všechny
- uses .ai/local/state/checkpoints
- uses .ai/local/state/decisions.md
- uses .ai/local/state/handovers
- uses .ai/local/state/ledger.jsonl
- uses .ai/local/state/open-questions.md
session_context modul
- sources lib/context.sh
local/state/sessions artifact
local/state/locks/outbox-drain artifact
local/state/locks/session-pointer artifact
sha256 modul
local/evidence/use-cases artifact
local/evidence/live artifact
watch modul
co se rozešlo: stav, politika, projekce, retence
- sources lib/check.sh
- sources lib/context.sh
- sources lib/decision.sh
- sources lib/doctor.sh
- sources lib/handover.sh
- sources lib/prompt.sh
- sources lib/question.sh
- uses .ai/local/state/checkpoints
- uses .ai/local/state/handovers
- uses .ai/local/state/ledger.jsonl

42moduly

49stavové soubory

21zápisové cesty

Každé číslo výše je spočítáno ze skenu při sestavení. Skener je scripts/lib/architecture-scan.awk; data, která vytvořil pro toto sestavení, jsou v architecture.json.