Documentation
Everything needed to run the system locally: install it, register it as a stdio MCP server, then drive audits, browser verification, and consolidated quality gates from the CLI.
Installation
Source and package installation, the offline release check, and exact setup for nine MCP-capable agents.
MCP tools
Twenty scoped tools across knowledge retrieval, contract validation, audit, runtime verification, and release decisions.
CLI workflows
Every command-line workflow: portfolio benchmarking, audits, validation, comparison compilation, and the quality gate.
Knowledge precedence
Use sources in this order. Historical research sits outside the supported workflow: it is not a runtime dependency, retrieval fallback, implementation authority, or a source to copy into production code.
- 1Current product requirements and repository behavior.
- 2Root SKILL.md.
- 3The selected benchmark contract and manifest.
- 4Maintained files in knowledge-base/.
- 5Public standards or official platform documentation when the maintained corpus has a declared gap.
Repository layout
| Path | Purpose |
|---|---|
| SKILL.md | Authoritative Agent Skill instructions. |
| src/server.ts | MCP server and tool registration. |
| src/audit/ | Static repository audit engine. |
| src/runtime/ | Browser verification and evidence capture. |
| src/contracts/ | Product-contract and journey validation. |
| src/heuristics/ | Structured heuristic-review evaluation. |
| src/design-intelligence/ | Design-deliverable schema, provenance, token, contrast, icon, and presentation validation. |
| src/interface-trust/ | Interface-state truth, claim-source traceability, and history or export provenance validation. |
| src/information-design/ | Operational metric, finding, chart, hierarchy, collection, and answer-flow validation. |
| src/product-brief/ | Evidence-backed product intake and generation-readiness validation. |
| src/comparison/ | Anonymous comparison, claim-ledger, evidence-integrity, and release-readiness validation. |
| src/corpus/ | Versioned corpus loading, deterministic case evaluation, scoring, and reporting. |
| src/retrieval/ | Approved-scope Markdown indexing and deterministic BM25 search. |
| src/quality-gate/ | Consolidated profile quality gate. |
| src/aggregate/ | Multi-profile release aggregation. |
| cli/ | Stdio server and command-line entrypoints. |
| knowledge-base/ | Approved maintained guidance, schemas, benchmarks, provenance, and dependency records. |
| tests/ | Contract, MCP, audit, runtime, and quality-gate regression tests. |
| ci/ | Deterministic fixture and product-workflow example. |
| .github/workflows/quality.yml | Active repository quality workflow. |