Řekněte jednou, k čemu je vaše práce, a ať to říká každá plocha

setup: why-catalogue
given:
  - 'the layer installed, with the why section and its three source classes seeded by init'
  - 'one moment, one audience and one area written as three files and committed'
steps:
  - id: the-section-explains-itself
    run: ['context', 'resolve', '.ai/repo/why/moments']
    note: 'the section has a contract from the first install, so the first moment is one file'
    expect:
      exit: 0
      stdout_contains: ['ai.repo.why']
  - id: discovered-not-registered
    run: ['knowledge', 'sources']
    note: 'the three files are knowledge because a source class discovered them, not because anything listed them'
    expect:
      exit: 0
      stdout_contains: ['^moment .*the-same-explanation-twice', '^audience .*small-team', '^area .*continuity']
  - id: nothing-was-registered
    run: ['init', '--extend']
    note: 'the section is seeded, not generated per entry: there is nothing left to add'
    expect:
      exit: 0
      stdout_contains: ['nothing to add']
  - id: still-healthy
    run: ['doctor']
    note: 'the layer is real, and the section is part of it'
    expect:
      exit: 0
      stdout_contains: ['doctor: 0 failure']
then:
  - 'the catalogue is a section of the layer from the first install, with its contract'
  - 'adding a moment is adding one file; the executable half of that is proved by test/cases/98_why_catalogue.sh'

setup: why-catalogue
given:
  - 'the layer installed, with the why section and its three source classes seeded by init'
  - 'one moment, one audience and one area written as three files and committed'
steps:
  - id: the-section-explains-itself
    run: ['context', 'resolve', '.ai/repo/why/moments']
    note: 'the section has a contract from the first install, so the first moment is one file'
    expect:
      exit: 0
      stdout_contains: ['ai.repo.why']
  - id: discovered-not-registered
    run: ['knowledge', 'sources']
    note: 'the three files are knowledge because a source class discovered them, not because anything listed them'
    expect:
      exit: 0
      stdout_contains: ['^moment .*the-same-explanation-twice', '^audience .*small-team', '^area .*continuity']
  - id: nothing-was-registered
    run: ['init', '--extend']
    note: 'the section is seeded, not generated per entry: there is nothing left to add'
    expect:
      exit: 0
      stdout_contains: ['nothing to add']
  - id: still-healthy
    run: ['doctor']
    note: 'the layer is real, and the section is part of it'
    expect:
      exit: 0
      stdout_contains: ['doctor: 0 failure']
then:
  - 'the catalogue is a section of the layer from the first install, with its contract'
  - 'adding a moment is adding one file; the executable half of that is proved by test/cases/98_why_catalogue.sh'

Scénář

Provedeno proti skutečnému nástroji v repozitáři připraveném pomocí why-catalogue, 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.

Co nástroj udělal

Důkazy o běhu, ze kterého byla tato stránka vygenerována: pass, kroků: 4. Výstup je normalizovaný: cesta k repozitáři, časová razítka, identifikátory 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.

1. 1$ majordomus context resolve .ai/repo/why/moments exit 0

   sekce má smlouvu od první instalace, takže první okamžik je jeden soubor

   # effective context for .ai/repo/why/moments
   01  ai.layer                   .ai/README.md                              subtree   final   *
   02  ai.repo                    .ai/repo/README.md                         subtree   extend  *
   03  ai.repo.why                .ai/repo/why/README.md                     subtree   extend  *

   • exit 0
   • stdout_contains /ai.repo.why/
2. 2$ majordomus knowledge sources exit 0

   tyto tři soubory jsou znalosti proto, že je objevila zdrojová třída, ne proto, že je cokoli uvedlo

   context     shared      context    77afef342ab6  .ai/README.md
   context     shared      context    fa986a58b371  .ai/repo/README.md
   context     shared      context    210fe3243d2c  .ai/repo/adrs/README.md
   context     shared      context    6dc507447b9f  .ai/repo/applications/README.md
   context     shared      context    06b0af6581a4  .ai/repo/deployments/README.md
   context     shared      context    18111b83801f  .ai/repo/features/README.md
   context     shared      context    c1ae02e4d03c  .ai/repo/knowledge/README.md
   context     shared      context    9939471c0d0a  .ai/repo/knowledge/candidates/README.md
   context     shared      context    3be0a8483464  .ai/repo/knowledge/curated/README.md
   context     shared      context    cb11ba2b8aeb  .ai/repo/profiles/README.md
   context     shared      context    b09939447728  .ai/repo/project/README.md
   context     shared      context    aaade142a03c  .ai/repo/prompts/README.md
   context     shared      context    fa27e74a38c5  .ai/repo/rules/README.md
   context     shared      context    39f8246be04e  .ai/repo/rules/project/README.md
   context     shared      context    07e9f6f77e38  .ai/repo/sessions/README.md
   context     shared      context    c08c8f28ce3d  .ai/repo/skills/README.md
   context     shared      context    99905d2cd5a9  .ai/repo/use-cases/README.md
   context     shared      context    95d10752d6ae  .ai/repo/why/README.md
   context     shared      context    124141e223e4  .ai/repo/workflows/README.md
   policy      shared      policy     e35e451d733d  .ai/repo/policy.yaml
   scope       shared      scope      264ce22ddc67  .ai/repo/scope.yaml
   profile     shared      profile    2bbbd4d3b45b  .ai/repo/profiles/debugging.yaml
   profile     shared      profile    4e0b1ed0bb8c  .ai/repo/profiles/deep-work.yaml
   profile     shared      profile    4e4fe1af1c3d  .ai/repo/profiles/implementation.yaml
   profile     shared      profile    c3f4f310c328  .ai/repo/profiles/routine.yaml
   rule        shared      rule       fa27e74a38c5  .ai/repo/rules/README.md
   rule        shared      rule       39f8246be04e  .ai/repo/rules/project/README.md
   rule        shared      rule       8513b44dfe15  .ai/repo/rules/vendor/majordomus/rules/adr-integrity.v1.md
   rule        shared      rule       1c35b4925c67  .ai/repo/rules/vendor/majordomus/rules/ai-layout-integrity.v1.md
   rule        shared      rule       6b737b2767d6  .ai/repo/rules/vendor/majordomus/rules/blocker-resolution.v1.md
   rule        shared      rule       d6a33fc1b28c  .ai/repo/rules/vendor/majordomus/rules/bootstrap-integrity.v1.md
   rule        shared      rule       f8137aa6fcd4  .ai/repo/rules/vendor/majordomus/rules/candidates-reviewed.v1.md
   rule        shared      rule       826525b6e3a9  .ai/repo/rules/vendor/majordomus/rules/catalogue-integrity.v1.md
   rule        shared      rule       a56642f78cc5  .ai/repo/rules/vendor/majordomus/rules/checkpoint-freshness.v1.md
   rule        shared      rule       78f8269d371d  .ai/repo/rules/vendor/majordomus/rules/command-coverage.v1.md
   rule        shared      rule       e468040ac890  .ai/repo/rules/vendor/majordomus/rules/command-surface.v1.md
   rule        shared      rule       adf88f652092  .ai/repo/rules/vendor/majordomus/rules/completion-gates.v1.md
   rule        shared      rule       523fbb99c024  .ai/repo/rules/vendor/majordomus/rules/context-budget.v1.md
   rule        shared      rule       018f8d63e837  .ai/repo/rules/vendor/majordomus/rules/context-integrity.v1.md
   rule        shared      rule       f5336d1b0b06  .ai/repo/rules/vendor/majordomus/rules/dag-integrity.v1.md
   rule        shared      rule       d804fedbbf1a  .ai/repo/rules/vendor/majordomus/rules/decision-records.v1.md
   rule        shared      rule       072a8155ad66  .ai/repo/rules/vendor/majordomus/rules/decision-threshold.v1.md
   rule        shared      rule       5180a026347d  .ai/repo/rules/vendor/majordomus/rules/deployment-contract.v1.md
   rule        shared      rule       2033490a50b9  .ai/repo/rules/vendor/majordomus/rules/doctrine-wiring-integrity.v1.md
   rule        shared      rule       afc294593532  .ai/repo/rules/vendor/majordomus/rules/enforcement-wiring.v1.md
   rule        shared      rule       db680840291e  .ai/repo/rules/vendor/majordomus/rules/handover-integrity.v1.md
   rule        shared      rule       3427bfc92e29  .ai/repo/rules/vendor/majordomus/rules/knowledge-graph.v1.md
   rule        shared      rule       eec2b2184f6c  .ai/repo/rules/vendor/majordomus/rules/knowledge-integrity.v1.md
   rule        shared      rule       33fc8bac42c8  .ai/repo/rules/vendor/majordomus/rules/knowledge-observed.v1.md
   rule        shared      rule       ebe4eb49d09c  .ai/repo/rules/vendor/majordomus/rules/layout-integrity.v1.md
   rule        shared      rule       d3c88435f42d  .ai/repo/rules/vendor/majordomus/rules/ledger-integrity.v1.md
   rule        shared      rule       628f11b96703  .ai/repo/rules/vendor/majordomus/rules/lifecycle-observed.v1.md
   rule        shared      rule       d1bb01668123  .ai/repo/rules/vendor/majordomus/rules/note-integrity.v1.md
   rule        shared      rule       88f7f9322b00  .ai/repo/rules/vendor/majordomus/rules/obligation-closure.v1.md
   rule        shared      rule       51e122071249  .ai/repo/rules/vendor/majordomus/rules/policy-completeness.v1.md
   rule        shared      rule       ae11a7b983a5  .ai/repo/rules/vendor/majordomus/rules/policy-integrity.v1.md
   rule        shared      rule       84f5b9f70992  .ai/repo/rules/vendor/majordomus/rules/principle-01-sessions-are-workers.v1.md
   rule        shared      rule       cbd041431c84  .ai/repo/rules/vendor/majordomus/rules/principle-02-minimum-sufficient-context.v1.md
   rule        shared      rule       c02aa47f226c  .ai/repo/rules/vendor/majordomus/rules/principle-03-externalise-decisions.v1.md
   rule        shared      rule       fb8aff3c3984  .ai/repo/rules/vendor/majordomus/rules/principle-04-one-worker-one-scope.v1.md
   rule        shared      rule       7fa1a1c5c27e  .ai/repo/rules/vendor/majordomus/rules/principle-05-justified-escalation.v1.md
   rule        shared      rule       87de78333726  .ai/repo/rules/vendor/majordomus/rules/principle-06-depth-is-not-verbosity.v1.md
   rule        shared      rule       a843319fda37  .ai/repo/rules/vendor/majordomus/rules/principle-07-define-done-first.v1.md
   rule        shared      rule       1b01d93b42fa  .ai/repo/rules/vendor/majordomus/rules/principle-08-verify-outcomes.v1.md
   rule        shared      rule       5eae52cc5589  .ai/repo/rules/vendor/majordomus/rules/principle-09-isolated-parallelism.v1.md
   rule        shared      rule       c7307cc9d919  .ai/repo/rules/vendor/majordomus/rules/principle-10-handovers-carry-state.v1.md
   rule        shared      rule       abbd45d5b53e  .ai/repo/rules/vendor/majordomus/rules/profile-requirements.v1.md
   rule        shared      rule       f2fd82b09aaa  .ai/repo/rules/vendor/majordomus/rules/project-integrity.v1.md
   rule        shared      rule       bc3eadf4f9f5  .ai/repo/rules/vendor/majordomus/rules/projection-integrity.v1.md
   rule        shared      rule       6a768205d5ed  .ai/repo/rules/vendor/majordomus/rules/prompt-capture.v1.md
   rule        shared      rule       5d4230b7c618  .ai/repo/rules/vendor/majordomus/rules/prompt-continuity.v1.md
   rule        shared      rule       c820246fbdc1  .ai/repo/rules/vendor/majordomus/rules/prompt-integrity.v1.md
   rule        shared      rule       9b68dbd49ac6  .ai/repo/rules/vendor/majordomus/rules/publication-currency.v1.md
   rule        shared      rule       58fca43f73a9  .ai/repo/rules/vendor/majordomus/rules/questions-store-integrity.v1.md
   rule        shared      rule       4043b457e438  .ai/repo/rules/vendor/majordomus/rules/record-changed-files.v1.md
   rule        shared      rule       6ac34a128a32  .ai/repo/rules/vendor/majordomus/rules/retention-caps.v1.md
   rule        shared      rule       959aad5152d0  .ai/repo/rules/vendor/majordomus/rules/roadmap-integrity.v1.md
   rule        shared      rule       e254bad15ecd  .ai/repo/rules/vendor/majordomus/rules/rule-package-integrity.v1.md
   rule        shared      rule       d73fb1b2f702  .ai/repo/rules/vendor/majordomus/rules/schema-integrity.v1.md
   rule        shared      rule       5bae41c80fda  .ai/repo/rules/vendor/majordomus/rules/scope-integrity.v1.md
   rule        shared      rule       2e5b9f5ad9c7  .ai/repo/rules/vendor/majordomus/rules/session-lifecycle.v1.md
   rule        shared      rule       8f779c44c5c2  .ai/repo/rules/vendor/majordomus/rules/session-records.v1.md
   rule        shared      rule       5beb962c3c18  .ai/repo/rules/vendor/majordomus/rules/skill-integrity.v1.md
   rule        shared      rule       70a6e878886b  .ai/repo/rules/vendor/majordomus/rules/state-consistency.v1.md
   rule        shared      rule       7e381d15f9f3  .ai/repo/rules/vendor/majordomus/rules/task-continuity.v1.md
   rule        shared      rule       2a25cd588cea  .ai/repo/rules/vendor/majordomus/rules/task-on-the-mesh.v1.md
   rule        shared      rule       1955176df430  .ai/repo/rules/vendor/majordomus/rules/use-case-coverage.v1.md
   rule        shared      rule       1a2e830a8912  .ai/repo/rules/vendor/majordomus/rules/verification-integrity.v1.md
   prompt      shared      prompt     aaade142a03c  .ai/repo/prompts/README.md
   prompt      shared      prompt     cd5ec861eb54  .ai/repo/prompts/continue.md
   prompt      shared      prompt     8a5e3920d4a3  .ai/repo/prompts/debug.md
   prompt      shared      prompt     17dba8771fc4  .ai/repo/prompts/handover.md
   prompt      shared      prompt     16d69f71530d  .ai/repo/prompts/review.md
   workflow    shared      document   124141e223e4  .ai/repo/workflows/README.md
   workflow    shared      document   a43c0936e7e3  .ai/repo/workflows/continuity.md
   workflow    shared      document   726b52e6993e  .ai/repo/workflows/plan.md
   workflow    shared      document   39db3723e051  .ai/repo/workflows/task-lifecycle.md
   workflow    shared      document   09ea91004f94  .ai/repo/workflows/use-cases.md
   session     shared      session    07e9f6f77e38  .ai/repo/sessions/README.md
   curated     shared      knowledge  3be0a8483464  .ai/repo/knowledge/curated/README.md
   candidates  shared      knowledge  9939471c0d0a  .ai/repo/knowledge/candidates/README.md
   use_case    shared      use-case   99905d2cd5a9  .ai/repo/use-cases/README.md
   taxonomy    shared      taxonomy   207a79579af9  .ai/repo/use-cases/taxonomy.yaml
   moment      shared      moment     f359c4ee6275  .ai/repo/why/moments/the-same-explanation-twice.md
   audience    shared      audience   a79886aec100  .ai/repo/why/audiences/small-team.md
   area        shared      area       627dd1df16a7  .ai/repo/why/areas/continuity.md
   feature     shared      feature    18111b83801f  .ai/repo/features/README.md
   application shared      application 6dc507447b9f  .ai/repo/applications/README.md
   readme      shared      document   f86d73e50efe  AGENTS.md
   readme      shared      document   43d3dc87b4bd  CLAUDE.md
   readme      shared      document   d38758fca5f2  GEMINI.md
   decisions   operational decision   0885fc07773e  .ai/local/state/decisions.md
   questions   operational question   ebeb154be99d  .ai/local/state/open-questions.md
   knowledge sources: 113 file(s) in scope all

   • exit 0
   • stdout_contains /^moment .*the-same-explanation-twice/
   • stdout_contains /^audience .*small-team/
   • stdout_contains /^area .*continuity/
3. 3$ majordomus init --extend exit 0

   sekce je naplněna předem, negeneruje se po položkách: není co dalšího přidávat

   nothing to add; .ai/ already carries every file the skeleton seeds
   local state: .ai/local/state/ (ignored by git; this checkout's own)
   next: majordomus update      # generate the provider instruction files named in the policy
   next: majordomus doctor      # verify nothing is declared that is not wired
   hooks are not installed by init; add these two lines yourself, doctor verifies them:
     pre-commit: majordomus doctor || exit $?
     pre-push:   majordomus finish --check || exit $?

   • exit 0
   • stdout_contains /nothing to add/
4. 4$ majordomus doctor exit 0

   vrstva je skutečná a sekce je její součástí

   OK   knowledge   graph — buildable here: 101 node(s), 58 edge(s), compiled into a temporary file and removed; no stored index to go stale
   OK   knowledge   records — 0 record(s) valid against knowledge/v1; every reference resolves  [reproduce: majordomus knowledge check]
   OK   knowledge   candidates — 0 await review, cap 40
   OK   layout      .ai/manifest.yaml — schema ai-repository/v1
   OK   layout      .ai/repo/scope.yaml — version 1; 14 in pathspec(s); every key is one the schema declares
   OK   layout      .ai/local/ — ignored, and nothing under it is tracked
   OK   layout      .ai/ — every section the manifest names exists; the layer is readable without the tool
   OK   layout      .ai/repo/prompts — present
   OK   layout      .ai/local/state/handovers — present, 0 record(s)
   OK   layout      .ai/local/state/checkpoints — present, 0 record(s)
   OK   records     ledger.jsonl — every line is a well-formed event
   OK   policy      39 key(s) — every policy value the code reads is declared, with no reader-side default
   OK   bootstrap   3 projection(s) — each points at .ai/README.md, carries no rule of its own and names only rules in force
   OK   catalogue   0 use case(s), 0 application(s) — every command, doctrine, claim, responsibility, category, setup and cross-reference resolves, both directions
   OK   context     .ai/ — 19 context document(s) carry the contract; ids unique, references resolve, no final document superseded, no cycle  [reproduce: majordomus context validate]
   OK   policy      .ai/repo/policy.yaml — parsed, version 1
   OK   profiles    4 files — parsed; default 'implementation' exists
   INFO adr         .ai/repo/adrs/ — no decisions; nothing to validate
   OK   records     decisions.md — every entry is attributable
   INFO project     .ai/repo/project — no canonical project model here; nothing to validate
   OK   command     surface — 30 public command(s), reconciled against the dispatch table  [reproduce: majordomus doctor]
   OK   doctrine    50 of 61 rule(s) carry a validator — validator, dispatch, propagation, test and CI resolve for every one of the 50; the remaining 11 declare no validator and this check does not examine them
   OK   wiring      doctor-on-commit — wired via .githooks/pre-commit
   OK   wiring      finish-on-push — wired via .githooks/pre-push
   OK   command     coverage — every public command is exercised and refuted  [reproduce: bash test/run.sh 31_command_coverage]
   OK   resolver    handovers — no record for this worktree and branch (absence, not a stale match)  [reproduce: majordomus handover --resolve]
   OK   lifecycle   activity — 0 episode(s) opened here; too few to judge whether the writers stopped
   OK   knowledge   wiring — the close path and the compaction adapter call the deriver
   OK   knowledge   deriver — no episode has closed here; nothing to judge
   INFO project     .ai/repo/project — no canonical project model here; nothing to validate
   OK   projection  AGENTS.md — content matches its stamp
   OK   projection  CLAUDE.md — content matches its stamp
   OK   projection  GEMINI.md — content matches its stamp
   OK   budget      AGENTS.md — 42 lines, budget 150
   OK   links       AGENTS.md — all references resolve
   OK   counts      AGENTS.md — no hardcoded counts
   OK   context     builder — 21 lines, budget 300  [reproduce: majordomus context]
   OK   capture     share/schemas/majordomus/capture/capture.v1 — 2 file(s) describe majordomus.capture/v1 at the path the identifier derives: the record as JSON Schema, the document as protobuf
   OK   capture     .ai/local/prompts — ignored and untracked
   OK   capture     .ai/local/prompts — no records yet; the archive is empty
   OK   capture     .ai/local/prompts — every prompt is present as all three: the record, the Markdown and the YAML
   OK   prompts     .ai/local/prompts — the archive and every record in it are readable by their owner only
   OK   prompts     .ai/local/prompts — no records yet; the archive is empty
   OK   prompt      4 asset(s) — front matter valid, every token known
   OK   records     open-questions.md — every entry parses
   OK   retention   ledger — 1 lines, cap 5000
   OK   retention   handovers — 0 files, cap 200
   OK   retention   checkpoints — 0 files, cap 500
   OK   retention   sessions — 0 records, cap 500
   INFO project     .ai/repo/project — no canonical project model here; nothing to validate
   OK   rules       .ai/repo/rules/vendor/majordomus — every file matches the manifest (1 (1.0.0-alpha.4))
   OK   rules       61 rule(s) — resolve in one deterministic order; vendored baseline plus project rules, no override — 51 carry a validator, 10 are normative text this tool does not check
   OK   rules       blocking — all 44 blocking rule(s) carry a validator
   OK   schema      rules — 61 rule(s) resolve in one order: the vendored baseline in manifest order, then the project's, as a dependency graph
   OK   schema      share/kinds.yaml — 36 kind(s); every one that carries metadata declares a schema
   OK   schema      share/schemas — 53 schema(s), each valid JSON and each applied — by a kind, through an allow-list the tool reads, by a validator that names it, or as a generated document's contract (15)
   OK   records     0 record(s) — every changed_files names work, not generated or local state
   OK   session     .ai/local/session-contexts — ignored and untracked
   OK   session     .ai/local/session-contexts — no working contexts yet; the store is empty
   INFO skill       .ai/repo/skills/ — no skills; nothing to validate
   INFO use-case    30 advisory gap(s) — not covered by an active use case, and the policy does not require it: command:init command:update command:doctor command:watch command:start command:context command:checkpoint command:handover command:check command:finish command:history command:decision command:question command:prompt command:evidence command:skills command:capture command:search command:doctrine command:plan command:version command:session command:knowledge command:adr command:usecase command:rules command:migrate command:recover command:bench command:archive  [reproduce: majordomus usecase coverage]
   OK   use-case    0 of 30 target(s) covered — every public command the policy requires is named and run by an active use case (policy use_cases.coverage)
   INFO env         - — bash <version>, git <version>, jq <version>, shellcheck present
   WARN clone       unpushed — commits on no remote: main(3) — work on one disk is invisible to every other session and cannot be integrated  [reproduce: git push -u origin <branch>]
   OK   clone       uncommitted — no linked worktree, so no uncommitted work can sit in one
   INFO clone       trunk — no remote-tracking branch, so this checkout's distance from the remote trunk cannot be measured
   ·    reasoning   <decided by the advisors and the executable of the recording machine>
   ·    budget      doctor — <timed against the policy budget>
   doctor: 0 failure(s)

   • exit 0
   • stdout_contains /doctor: 0 failure/

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.

• majordomus initVytvoří vrstvu .ai/ v tomto repozitáři a odmítne přepsat existující.
• majordomus contextCo potřebuje vědět další worker právě teď, v pořadí podle autority a v rámci rozpočtu.
• majordomus knowledgeZkompilovaný index nad tím, co tento repozitář uvádí, a kandidátní záznamy, které odvozuje z toho, co epizoda udělala.
• majordomus doctorKontroluje jen governance: je samotný Majordomus zdravý a je každé vynucování, které deklaruje, tady skutečně zapojeno?

Přes MCP se k téže vrstvě dostanete pomocí majordomus_why, majordomus_why_moment, majordomus_why_audiences, majordomus_why_areas, majordomus_why_diagnose, majordomus_why_validate (povrch MCP).

Pravidla, díky nimž platí

• ✕blokující Integrita kontextuKaždý adresář AI vrstvy nese kontextový dokument, každý nese smlouvu, skládají se do jednoho deterministického řetězce pro každou cestu a strom, který se neověří, nevyřeší nic.
• ✕blokující Integrita AI vrstvyAI vrstva repozitáře je skutečná: manifest deklaruje formát, který tento spustitelný soubor čte, a každá sekce, kterou jmenuje, existuje, lokální část checkoutu je ignorovaná gitem a nic pod ní není sledováno a pod cestou .majordomus/ z doby před .ai nezůstala žádná projektová data.
• ✕blokující Integrita projekcíKaždý vygenerovaný instrukční soubor existuje, shoduje se s razítkem, které nese, a po ruční úpravě se nikdy tiše nepřepíše.

Uplatněné záruky

• ○zaručeno Kontext, který se vztahuje na cestu, se skládá z dokumentů vrstvy s rozsahem, od kořene k cíli, v jednom deterministickém pořadí s původem, a strom, který neprojde validací, nevyřeší nic
• ○zaručeno O tom, co server MCP servíruje, rozhoduje manifest, deklarované třídy zdrojů a front matter každého souboru, takže objekt přidaný do vrstvy se servíruje bez jakékoli změny spustitelného souboru
• ○zaručeno MCP, HTTP, OpenAPI, Swagger UI, příkazy schopností a vygenerovaná reference jsou odvozeny z registru a změna jedné definice se projeví ve všech
• ○zaručeno Způsob čtení každého deklarativního druhu a klíče, které smí nést, jsou data načítaná za běhu; repozitář přidá druh spolu s jeho JSON Schema bez změny kódu
• ○záruka Commitnuté projekce, dokument OpenAPI, reference schopností a allow-listy se znovu generují z registru a schémat a generate --check zastaralou odmítne
• ○zaručeno Provozní okamžik je jeden soubor ve vrstvě, objevený, ne registrovaný, a odpovídá na něj příkazová řádka, HTTP API, dokument OpenAPI, MCP, odvozený graf i web, aniž by se cokoli jiného měnilo
• ○zaručeno Každý odkaz, který moment činí, se rozřeší proti věci, kterou jmenuje, a ten, který ne, je chyba nesoucí nejbližšího kandidáta
• ○zaručeno Diagnóza vlastních příznaků čtenáře je deterministické počítání nad metadaty katalogu a každé doporučení jmenuje momenty, které ho vyvolaly

Související případy užití

Vypočteno z toho, co sdílejí: tvrzení, pravidla, příkazy, kategorie, aplikace. Tento seznam nikdo neudržuje.

• Rozšiřte, co spustitelný soubor poskytuje, přidáním souboru, nikdy jeho přebuildovánímPřidejte do .ai/ pravidlo, prompt nebo uzel znalostí a nechte je objevit se jako zdroj MCP, HTTP route a položka reference, se stejným binárním souborem.
• Podívat se, co repozitář obsahuje, a spustit jednu z jeho schopností, bez čtení souboruOtevř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.
• Dohledat změnu k dokumentům kontextu, kterých se týkáVypíše dokumenty kontextu s rozsahem, vyřeší, které se vztahují na cestu a proč, a zjistí, kterých dokumentů se změna dotýká, než přistane.
• Odmítnout adresář vrstvy, který nic nedokumentujeAdresář přidaný do vrstvy bez kontextového dokumentu selže při validaci jménem, nic se proti stromu nevyřeší, dokud neřekne, k čemu je, a stejná hierarchie je čitelná přes MCP a API, aniž by se spouštěla kontrola.
• Servírujte vrstvu AI repozitáře každému klientu AI přes jeden sdílený serverOtevřete repozitář v kterémkoli klientu, pro nějž nástroj deklaruje providera (docs/generated/providers.md), a nechte každého číst stejná pravidla, prompty a znalosti přes MCP z jednoho procesu, přičemž se navzájem vidí.