A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live
Directories
Every directory of the layer, the contract it declares, and the chain it inherits. Derived from the index through `directories.list`; the Cockpit lists no directory itself.
Coverage
60directoriesthe layer, from the index
39documentedcarry a contract
21exemptreleased from above
0owedowe one and have none
Every directory here says what it is for, or a contract above it says why it need not. These are the directories the index holds content for; the gate that walks the working tree and refuses a commit is `majordomus context validate`.
Local contract — .ai
documented- Identity
ai.layer- Document
.ai/README.md- Scope
- subtree
- Composition
- final
- Order
- 10
- Status
- active
- Providers
- *
- Audience
- human, agent
Effective contract
What applies here once inheritance is resolved: every document whose scope reaches this directory, least specific first — depth, then declared order, then path. This is the chain `majordomus context resolve` composes.
| Depth | Document | Origin | Composition | Order | Why |
|---|---|---|---|---|---|
| 0 | ai.layer | local | final | 10 | the target directory (scope subtree) |
The hierarchy
| Directory | State | Contract | Decided by | Objects |
|---|---|---|---|---|
| .ai | documented | ai.layerThe protocol of the layer: what it holds, who owns which half, how it is discovered, and what outranks what. | nothing declares it | 1 |
| repo | documented | ai.repoThe tracked half of the layer and what each section under it is for. | nothing declares it | 3 |
| adrs | documented | ai.repo.adrsAccepted, durable decisions about how this repository is built. | nothing declares it | 118 |
| applications | documented | ai.repo.applicationsThe contexts the tool suits, when each fits and when it does not, composed from use cases. | nothing declares it | 6 |
| automation | documented | ai.repo.automationEvery unit of this repository's automation, its migration disposition, and the exemption that allows a shell unit to remain shell. | nothing declares it | 1 |
| benchmarks | documented | ai.repo.benchmarksThe recorded baselines a performance claim is compared against, one directory per measured surface. | nothing declares it | 1 |
| economics | documented | ai.repo.benchmarks.economicsThe methodology, suites and task corpus that measure what a session consumes with Majordomus and without it, and the raw runs recorded under them. | .ai/repo/benchmarks/economics/README.md | 1 |
| observatory | documented | ai.repo.benchmarks.observatoryThe gates of the Observatory (G0 to G7) with their verdicts, and the browser measurements behind them, each naming its revision, command and machine. | .ai/repo/benchmarks/observatory/README.md | 1 |
| pages | documented | ai.repo.benchmarks.pagesWhat publishing the site cost on a named platform, kept as the comparison for the next run. | nothing declares it | 1 |
| rust | documented | ai.repo.benchmarks.rustPer-platform baselines for the Rust executable's commands, with the policy that decides a regression. | nothing declares it | 1 |
| ci | documented | ai.repo.ciThe gates this repository runs, which changed paths select them, and what publication may spend. | nothing declares it | 1 |
| deployments | documented | ai.repo.deploymentsOne canonical object per deployment of this repository's executable; every artifact built from it — the container image definition and its ignore file — is generated from it and none of them is authoritative. | nothing declares it | 2 |
| evidence | documented | ai.repo.evidenceThe recorded executions a claim's proof is read from — what ran, against which commit, and with what result. | nothing declares it | 1 |
| features | documented | ai.repo.featuresWhat the product does for a person, one feature per file, each made of things the other registries already own; every surface that presents a feature is derived from these files. | nothing declares it | 30 |
| domains | documented | ai.repo.features.domainsThe few things the product controls, one domain per file; every feature names exactly one, and each domain's members, interfaces and evidence are derived from the features that name it. | nothing declares it | 7 |
| knowledge | documented | ai.repo.knowledgeHow repository knowledge is declared and discovered, never collected. | nothing declares it | 1 |
| candidates | documented | ai.repo.knowledge.candidatesWhat the tool derived from the ledger and git at an episode boundary and nobody has reviewed yet, discovered as a knowledge source class. | nothing declares it | 1 |
| curated | documented | ai.repo.knowledge.curatedWhat this repository chose to write about itself, discovered as a knowledge source class. | nothing declares it | 5 |
| mesh | documented | ai.repo.meshOne canonical object that says whether this repository's servers participate in mesh discovery, over which transports, and whom they trust; absent or disabled means no socket opens. | nothing declares it | 2 |
| observatory | documented | ai.repo.observatoryThe recording of the mesh scenes the published Observatory replays where no mesh runs, captured from a running server and committed. | nothing declares it | 1 |
| offload | documented | ai.repo.offloadThe one declaration of the machines a branch's derive may be offloaded to and the limits each must meet; `majordomus offload` reads it, and no script carries a host address. | nothing declares it | 2 |
| profiles | documented | ai.repo.profilesHow much context, effort and ceremony a task gets, declared per working mode. | nothing declares it | 5 |
| project | documented | ai.repo.projectMilestones as outcomes, issues as execution contracts, and a dependency graph that decides what is next. | nothing declares it | 1 |
| critiques | documented | ai.repo.project.critiquesThe adversarial pass over an intent's plan, as structured findings with their resolutions. | nothing declares it | 5 |
| gaps | documented | ai.repo.project.gapsWhat a worker observed of this repository against an intent's criteria, at one commit. | nothing declares it | 5 |
| intents | documented | ai.repo.project.intentsWhat must become true above the milestones that realise it, with the evidence that settles it. | nothing declares it | 6 |
| issues | documented | ai.repo.project.issuesExecution contracts: one bounded change each, with its scope, its dependencies and the evidence it must leave. | nothing declares it | 425 |
| milestones | documented | ai.repo.project.milestonesOne outcome each, written as the problem it ends and the state that proves it ended. | nothing declares it | 42 |
| prompts | documented | ai.repo.promptsThe provider-neutral prompts the tool renders, with the tokens it fills in. | nothing declares it | 5 |
| providers | documented | ai.repo.providersThe one source each provider bootstrap is rendered from; the files at the root are output. | nothing declares it | 1 |
| releases | documented | ai.repo.releasesOne record per published release, written by the release pipeline and read by every projection of the public release metadata. | nothing declares it | 30 |
| rules | documented | ai.repo.rulesThe rule object format, where rules live, how they are loaded and composed. | .ai/repo/rules/README.md | 1 |
| project | documented | ai.repo.rules.projectThe rules this repository wrote for itself, one file each, resolved with the vendored baseline. | .ai/repo/rules/README.md | 127 |
| vendor | exempt | no contract of its own | .ai/repo/rules/README.md | 0 |
| majordomus | exempt | no contract of its own | .ai/repo/rules/README.md | 0 |
| rules | exempt | no contract of its own | .ai/repo/rules/README.md | 61 |
| sessions | documented | ai.repo.sessionsOne immutable record per closed execution episode, derived from git and the ledger and shared with every surface. | nothing declares it | 91 |
| skills | documented | ai.repo.skillsReusable provider-neutral operational procedures, loaded only when the task is about them. | .ai/repo/skills/README.md | 1 |
| assess-before-deleting | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| examples | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| deploy-site | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| evolve | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| examples | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| implement | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| examples | exempt | no contract of its own | .ai/repo/skills/README.md | 5 |
| pack-for-chatgpt | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| examples | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| pack-for-review | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| examples | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| repo-review | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| examples | exempt | no contract of its own | .ai/repo/skills/README.md | 5 |
| report-verification-state | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| examples | exempt | no contract of its own | .ai/repo/skills/README.md | 1 |
| use-cases | documented | ai.repo.use-casesThe tasks people perform with the tool, each one a file with the commands, rules and claims it names and the scenario section that proves it. | nothing declares it | 60 |
| why | documented | ai.repo.whyThe operational moments this tool answers, the audiences that recognise them and the areas they fall under, each one a file that every projection is derived from. | .ai/repo/why/README.md | 1 |
| areas | exempt | no contract of its own | .ai/repo/why/README.md | 9 |
| audiences | exempt | no contract of its own | .ai/repo/why/README.md | 8 |
| moments | exempt | no contract of its own | .ai/repo/why/README.md | 38 |
| workflows | documented | ai.repo.workflowsThe multi-step processes a worker follows here, and when each applies. | nothing declares it | 5 |
| workspaces | documented | ai.repo.workspacesOne declaration per external workspace this repository is authorised to read; the content it names is this checkout's state and is never here. | nothing declares it | 2 |