Files
msd-core/docs/reference/capability-matrix.md
Jakub Zych 6cfa0c55d2 refactor: drop 12 runtimes, keep Claude, Codex, OpenCode, Cursor, ZCode, Antigravity
Removes kilo, kimi, kimi-code, copilot, windsurf, augment, trae, qwen, hermes,
cline, codebuddy and pi end to end: capability descriptors, installer branches
and converters (bin/install.js 14.9k -> 11.2k lines), TypeScript converters,
hook surfaces and runtime homes, review lanes qwen/kimi-code, the two pi
migrations, Kimi payload normalization in the hook guards, dead hostBehaviors
vocabulary, launcher home probes, fixtures, runtime-specific tests and the
prose that presented them as supported.

Installer output for the six kept runtimes is byte-identical to before the
prune. The Kimi tool-vocabulary tests in workflow-guard, read-guard and
read-injection-scanner are left in place pending a decision.
2026-10-06 20:02:40 +02:00

10 KiB

Capability matrix reference

Generated file — do not edit by hand. This matrix is generated from the capability registry by scripts/gen-capability-matrix.cjs and kept honest by a drift guard (tests/capability-matrix-sync.test.cjs runs --check). Any manual edit is overwritten on the next generation run. To change a capability's declared metadata, edit the corresponding capabilities/<id>/capability.json and run node scripts/gen-capability-matrix.cjs --write.

See also: ADR-1244 — Capability manifest fields — The capability trust model


Column definitions

Column Description
id Canonical capability identifier; unique across first- and third-party capabilities. Reserved prefixes: msd-, msd-core-, anthropic-.
role feature — extends what the loop does; runtime — adapts MSD to a specific AI runtime/IDE; reviewer — declares a cross-AI reviewer lane (ADR-2782). A capability may be both a runtime and a reviewer.
tier core — always active; standard — active when the runtime supports it; full — opt-in or runtime-specific.
engines.msd Semver RANGE expressing host-version compatibility. A hard gate at install and at load. — means the capability declares no range.
extension points The loop points this capability registers hooks into (from the registry's byLoopPoint index). — means it registers none (typical for runtime capabilities, whose job is surface emission).
hook kinds Which of step, contribution, gate the capability's hooks use. — means none.
source first-party — ships with MSD Core; third-party — installed from an external source via msd capability install.

On versions. This matrix intentionally omits a per-capability version column. First-party capabilities are versioned in lockstep with the MSD Core package (their capability.json version always equals the MSD release version), so a per-row version would simply repeat the package version and churn the committed file on every release. The stable host-compatibility signal — engines.msd — is shown instead. A third-party capability's exact version is recorded in the per-runtime ledger (.msd-capabilities.json) at install time.


Native (first-party) capabilities

First-party capabilities are implicitly trusted: they ship as part of the MSD Core package and are stamped with the package version at release (per ADR-1244 D6). They are not subject to the consent or integrity-pin flow applied to third-party capabilities.

Feature capabilities (role: feature) — 22

Feature capabilities extend what the loop does — contributing research, planning, execution, verification, or ship artefacts at the loop extension points.

id role tier engines.msd extension points hook kinds source
ai-integration feature full >=1.6.0 plan:pre, verify:pre step, contribution, gate first-party
assumption-delta feature full >=1.6.0 plan:pre contribution first-party
audit feature full >=1.6.0 — — first-party
broken-windows feature full >=1.7.0 ship:pre gate first-party
claude-orchestration feature full >=1.7.0 plan:post contribution first-party
code-review feature full >=1.6.0 execute:wave:post, execute:post step first-party
drift feature full >=1.6.0 plan:pre, execute:wave:post gate first-party
external-job feature full >=1.7.0 plan:post, execute:wave:post contribution first-party
gap-analysis feature standard >=1.6.0 plan:post gate first-party
graphify feature full >=1.6.0 — — first-party
intel feature full >=1.6.0 plan:pre step first-party
live-dom-uat feature full >=1.11.0 execute:wave:post step first-party
mempalace feature full >=1.6.0 discuss:pre, discuss:post, plan:pre, plan:post, execute:wave:post, verify:post, ship:post step, contribution first-party
nyquist feature full >=1.6.0 verify:post step first-party
pattern-mapper feature full >=1.6.0 plan:pre step first-party
profile-pipeline feature full >=1.6.0 — — first-party
refactor-trigger feature full >=1.10.0 execute:post step first-party
research feature standard >=1.6.0 plan:pre step first-party
schema-gate feature full >=1.6.0 plan:pre contribution first-party
security feature full >=1.6.0 plan:pre, verify:post, ship:pre step, contribution, gate first-party
tdd feature full >=1.6.0 plan:pre, execute:post contribution, gate first-party
ui feature full >=1.6.0 plan:pre, execute:wave:post, verify:post step, gate first-party

Runtime capabilities (role: runtime) — 7

Runtime capabilities adapt MSD to a specific AI runtime or IDE — emitting skills, agents, hooks configuration, and surface files for that host. They typically register no loop hooks (their primary responsibility is surface emission), so their extension-point and hook-kind cells are —.

id role tier engines.msd extension points hook kinds source
antigravity runtime core >=1.6.0 — — first-party
claude runtime core >=1.6.0 — — first-party
codex runtime core >=1.6.0 — — first-party
cursor runtime core >=1.6.0 — — first-party
opencode runtime core >=1.6.0 — — first-party
vscode runtime core >=1.7.0 — — first-party
zcode runtime core >=1.6.0 — — first-party

Reviewer capabilities (role: reviewer) — 4

Reviewer capabilities declare a cross-AI reviewer lane — one external CLI or model endpoint /msd-review hands a plan to (ADR-2782 D3). They are not install targets: they emit no skills, agents, hooks or surface files, so their extension-point and hook-kind cells are —. A host that is also a reviewer (Claude, Codex, Cursor, OpenCode, Qwen, Antigravity) keeps one manifest and appears under runtime above, carrying its lane alongside its runtime body; only lanes that MSD never installs into appear here.

Because a lane receives the plan text, requirements, research findings and CONTEXT.md decisions, it is a disclosed executable surface and is consent-gated at install like any other — see the trust model.

id role tier engines.msd extension points hook kinds source
coderabbit reviewer full >=1.8.0 — — first-party
llama-cpp reviewer full >=1.8.0 — — first-party
lm-studio reviewer full >=1.8.0 — — first-party
ollama reviewer full >=1.8.0 — — first-party

Third-party capabilities

This matrix is the first-party catalogue: it is generated from the committed registry and therefore lists only the capabilities that ship with MSD Core. Installed third-party capabilities are NOT written into this committed file. Once a user installs one via msd capability install <spec> it enters the runtime registry overlay (ADR-1244 D2); the overlay-aware view of what is installed on a given machine is msd capability list (see the msd capability command reference), which reports first-party and installed third-party capabilities together using the same column fields described below, with source = third-party.

Column values for third-party rows

Column Value
id As declared in capability.json. Must not use reserved prefixes (msd-, msd-core-, anthropic-).
role feature, runtime, or reviewer, as declared.
tier core, standard, or full, as declared.
engines.msd Range from capability.json; verified at install and at each load.
extension points The loop points the capability registers into, validated against the known 12 identifiers.
hook kinds step, contribution, and/or gate as declared. Disclosed in the consent summary at install.
source third-party

Community registry

Whether MSD operates or advertises a central community registry of third-party capabilities is TBD/TBA (PRD). The matrix mechanic and all manifest fields ship regardless of that decision; URL/git/npm/tarball import does not depend on a central registry.


Manifest field reference

The fields below are defined in capability.json and govern how a capability appears in this matrix. For the full schema, see ADR-1244 D1 and the capability manifest reference.

Field Required Type Purpose
version Yes semver string Capability version. The registry rejects manifests without it.
engines.msd Recommended semver range Host-version compatibility gate. Enforced at install and load.
compatVersions No object: cap-version → msd-range Graceful-downgrade table for sources that enumerate versions (git tags, registry, npm).
integrity No sha512-<base64> SHA-512 digest of the fetched bundle. Verified before extraction when present; mismatch aborts.
provenance No { sourceRepo, commit } Source provenance; populated in CI for first-party/curated capabilities.