screen · composed of the kit
Supervisory control layer
One repository.Many perspectives.One source of truth.
A lightweight supervisory control layer for AI-assisted work. It reads the repository's .ai/ layer into typed models and serves them to the command line, the HTTP API, MCP, the Cockpit and this site.
$ majordomus context
# 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 dirty task_record exact (recorded head <head>) ## TASK id t-<id> task narrow the parser profile implementation owner <owner> outcome active scope lib
1
Discover
Read what the repository already states
-
.ai/rules, ADRs, skills, sessions
-
gitbranch, head, working tree
-
share/kinds, schemas, the design
-
capabilitiesdeclared in the Rust sources
-
justfilethe workflows
-
toolchainsthe manifests that declare them
-
servicesthe shared server's lease
2
Build
One typed model of the repository
The registry index
each file the sources classify becomes a typed object or a diagnostic; the index holds objects of 34 kinds
- adr
- application
- area
- audience
- claim
- command
- context
- critique
- deployment
- derive-offload
- distribution-model
- document
- domain
- feature
- gap
- implementation
- intent
- issue
- knowledge
- mesh-declaration
- milestone
- moment
- policy
- profile
- prompt
- release-record
- rule
- scope
- session
- skill
- taxonomy
- test
- use-case
- workspace
3
Derive
Every surface a projection
- Command linemajordomus
- HTTP API/api/v1/
-
OpenAPI · Swagger UI/openapi.json · /swagger
- MCPmajordomus mcp
- Cockpit/cockpit
- DocumentationGitHub Pages
- Generated filesdocs/generated/
4
Use
Work from what is known
- Consistentevery surface renders the same value
- Deterministicthe same input, the same bytes
- Discoveredfound through declarations, not hand-kept lists
- Currentderived files are compared with their inputs
- Extensiblea new kind reaches every surface
- Provenanceevery environment value names where it came from
- Fits your workflowgit, just and direnv
- No hand-kept liststhe layer is discovered from the tracked tree
- For people and agentsCLI, HTTP, MCP, Cockpit, docs
- Open sourceMIT licence, on GitHub