Spec (Blueprint WB)
/spec/The roadmap, epics, stories and decisions - every page generated from Markdown in the repository, so the site and the source cannot disagree.
Capabilities
Aegis is 4 surfaces and the 19 capabilities that operate on them, listed from their own manifests and measured by the gate below.
Surfaces
Atlas
/atlasOne map from a code change up to what it ships as: services, infrastructure, blast radius, and the commercial exposure above them.
Environments (Env)
/environmentsA private, isolated environment with a live URL, in minutes.
Memory
/memoryWhat earlier sessions worked out, fed back to the agent before its first action - and the evidence that it is happening.
Skill Evaluation (Skill Eval FW)
pre-mergeEvery skill is measured before it merges: graders that can block, a judge that can only ask for a human, and signals that do neither.
AI configuration
Skills 14
Foundations
aegis-contextUse FIRST in any workbench task - resolves which roadmap item, epic and story you are in, then loads that item's own concept, ADRs and architecture live from the corpus. Skip only when the task is unambiguously outside the corpus.aegis-functionalDomain question-and-answer, and functional-to-technical translation. The grounding feeder every other capability calls on demand. Returns prose plus citations plus an explicit gaps list - never a raw dump, never an unsourced claim.Authoring
aegis-epicEpic lifecycle - create an epic under a roadmap item, update it losslessly, or sequence the epics to work out ordering and the critical path. An epic must reach ready before stories can be written against it.aegis-riCreate a roadmap-item folder from the template, or retrofit conventions onto an existing one. Refuses to create over an existing folder; retrofit adds only what is missing and touches nothing that is there.aegis-storyStory lifecycle - create one story, decompose an epic into many as a gated batch, update losslessly, or break a story into a task runbook. Critical tier - verifies every files_touched claim against the workspace and writes nothing on divergence.Engineering
aegis-architectShape architecture - entity models, ADRs, migration phasing and downstream impact - under a roadmap item's 10-architecture folder, or survey an existing codebase to draft the domain pack a brownfield project needs. May generate code only as a cited sample; it never lands code in the workspace.aegis-implementImplement a story end-to-end in the target workspace. The only capability that lands generated code. Test-first by default, and enforces the story's files_touched contract rather than treating it as a note.aegis-reviewReview code or a design pull request against a story's acceptance criteria, in three layers - the host's automated review, the target platform's own rule sets, and the workbench discipline gates. Every finding carries a severity.aegis-ui-testDrive the project's own web app in a real browser to verify a UI change actually works, and fix what is broken before calling it done. Not a report generator - it fixes and re-verifies in the same pass.Peripheral
aegis-defectRecord and work a post-delivery defect. Pickup gathers evidence and writes nothing; create writes the record and the story's index entry together. Attribution is proposed and evidenced, never asserted, and a done story is never reopened.aegis-docsAuthor and review end-user documentation for a roadmap item, on its own branch, with a plain-readable preview rather than raw markup. Documents delivered behaviour only - never what a story merely intends.aegis-grillTwo opposite modes on the option space - ideate opens it up with divergent alternatives, critique stresses what is already there with pre-mortem and red-team questioning. Never both at once; they are different cognitive acts.aegis-helpThe front door. Explains the workbench and routes you to the right capability. Names what is actually installed rather than the catalogue, and answers in one shot without invoking a backend.aegis-uxShape UX designs and land them under the roadmap item's 40-prototypes folder, reading from and writing to the design tool with explicit consent per target. Generates no code at all, in any circumstance.Agents 2
aegis-onboardBrings an existing codebase onto the workbench after install - confirms the project really is brownfield, names every readiness gap and what its absence costs, then sequences the capabilities that close them. Writes only the domain pack and the roadmap skeleton; never touches the project's own source.aegis-validatorAudits workbench content - frontmatter, slug discipline, link integrity, template conformance, defect symmetry, cross-item leakage and capability manifests - against _shared/conventions.md, AGENTS.md and CONTRIBUTING.md. Reports findings; never edits.Rules 3
aegis-devworldHow to deploy with the Aegis DevWorld platform - never write infrastructure files into the repository, and ask only what the code cannot answer.aegis-flowlens-architectureKairos component repos - create and maintain the architecture.json graph to the FlowLens contract on every code change, without asking or deferring.aegis-memoryProject memory - what to capture, how to write a card, and how to treat injected cards.Quality gate
Skill Evaluation Framework
The 14 skills above are measured in the pipeline before they merge. Agents and rules are not in scope yet.
The judge routes; it does not convict. Measured agreement across 21 judges is κ ≈ 0.489 at 84.8% exact match - below the adequacy threshold. Enough to route, not enough to rule.