Mechanism census

Every mechanism, by role and family. form (the shape it takes) and Enf. (soft/hard) are the cross-cuts (see README). Families 1–5 = the agent role (the fleet + work-producing substrate); family 6 = the models-bridge (the MBSE substrate between the two); families 7–11 = the product role (the shipped artifact). All 85 entries are fully written ().

Read this as a construction kit. The census below lists every mechanism by role and family. For the architecture behind the list — what the environment must be able to do, and which mechanisms give it those capabilities — start at Constructing the Governed Engineering Environment. The case produced 85 concrete mechanisms; comparative analysis reduced them to 24 canonical mechanisms under 9 capabilities, with the remainder retained as variants and known uses. That page groups every entry under its capability and names the eight compositions that are strong together.

Enf. = soft/hard (see README Two independent axes: move and form): Hard = deterministic (blocking / audit / signal); Soft = probabilistic (influences, cannot block); Soft·Hard = soft guidance with a hard counterpart. The Move column (constraint/sensor/package) and Model column (is-a-model/governs-a-model/) are the two book-thesis cross-cuts, independent of soft/hard.

Agent target

1. Context & dispatch substrate

What an agent knows and how it is launched.family folder

MechanismFormMoveModelEnf.Entry
Brief-lintingvalidationsensorHardbrief-linting.md
Docs hierarchy + governance indexvalidationpackageSoft·Harddocs-hierarchy.md
Dynamic context injectionagent-outputconstraintSoftdynamic-context-injection.md
Role-typed dispatchquality-gatesensorHardrole-typed-dispatch.md

2. Gates & merge-train

The path-to-production staircase for agent work.family folder

MechanismFormMoveModelEnf.Entry
Pre-commit hook (3-stanza, tree-sha markers)quality-gatesensorHardpre-commit-hook.md
Sentinel first-commit early-abortquality-gatesensorHardsentinel-first-commit.md
Merge-train MIS batchingquality-gatesensorHardmerge-train-mis-batching.md
Staged deploy gates (canary → smoke → promote)quality-gatesensorHardstaged-deploy-gates.md

3. Mediators & resource locks

Host-level wrappers that ration shared compute across concurrent worktrees. Three cap by cardinality — one resource-mediator pattern at three lock cardinalities (exclusive N=1 · bounded M=8 · a global mutex); the fourth caps by live pressure instead of count (an admit-before / shed-during gate on a GREEN/YELLOW/RED signal).family folder

MechanismFormMoveModelEnf.Entry
Test-serializer (N=1 flock on dotnet test)regressionsensorHardtest-serializer.md
Build-serializer (M=8 semaphore)validationsensorHardbuild-serializer.md
Aggregate-compute protection (lint-all host mutex)validationsensorHardaggregate-compute-protection.md
Resource-pressure gating (admit before, shed during)quality-gatesensorHardresource-pressure-gating.md

4. Lifecycle & observability

Live signal surfaces over the fleet.family folder

MechanismFormMoveModelEnf.Entry
Agent-registry (agent-registry.jsonl + marker cache)observabilitysensorHard (signal)agent-registry.md
Orchestrator-as-reactor over an event busobservabilitysensorHard (signal)typed-event-bus.md
Deploy heartbeats + stale-worker detectionobservabilitysensorHard (signal)deploy-heartbeats.md
Tombstone commits (lifecycle close records)audit-trailsensorHard (audit)tombstone-commits.md
Cron-alerts gateobservabilitysensorHard (blocking)cron-alerts-gate.md
Lifecycle hooks (turn-stop / compaction / session-start / pre-action)quality-gatepackageSoft·Hardlifecycle-hooks.md
Reflection-facet substrate (tempo-gated policy nudges)quality-gatepackageSoft·Hardreflection-facet-substrate.md
Caused-by provenance (agent-side change traceability)audit-trailpackageHardcaused-by-provenance.md

5. Governance-doc mechanisms

Documentation treated as enforced infrastructure.family folder

MechanismFormMoveModelEnf.Entry
CLAUDE.md rule index + cap lintvalidationpackageSoft·Hardclaude-md-rule-index.md
Mandatory snippet-table enforcementvalidationsensorHardmandatory-snippet-table.md
Epic Definition-of-Done (Final-Opus trust-nothing re-run)quality-gatepackageHardepic-definition-of-done.md
Doc-hygiene lints (index coverage, autogen provenance)validationsensorHarddoc-hygiene-lints.md
Operational playbooks (situation-keyed devops procedures)agent-outputconstraintSoftoperational-playbooks.md
Operator runbook skill (positive map + symptom index, ref-lint-kept)agent-outputpackageSoft·Hardoperator-runbook-skill.md
Epic & design-doc templatesagent-outputpackageSoft·Hardepic-and-design-templates.md
Independent pre-implementation design review (fresh reviewer rules on forks)quality-gatepackageSoft·Hardindependent-design-review.md
Enforce at the right semantic levelagent-outputconstraintgoverns-a-modelSoftsemantic-level-enforcement.md
Self-governance (recurring failure → tasteful control, fired on a cadence)agent-outputpackageSoft·Hardself-governance.md

Models-bridge

6. System models

One MBSE method (the trunk — seventeen subject-agnostic mechanisms) reified toward the two subjects the bridge couples: the product it ships and the orchestration that builds it (a Y). Eighteen models split product-facing (service-flow, user-journey, domain-registries, composed-state-machine, process-view) · orchestration-facing (synchronization, agent-orch, governance-graph, lifecycle) · shared-spine (component-zone, concurrency, deployment — both faces); the seventeen method-mechanisms — incl. formal temporal-logic verification, coverage→model-node mapping, journey-criticality → test-tier placement, invariant-DAG execution policy, computed control↔substrate blast-radius, and the symbol-anchored traceability graph — hold them all true. These model entries are a curated sample of the portable genres, not the whole zoo: the real substrate carries on the order of sixty typed models, and these cover the ones that transfer. Rows below are grouped trunk → product → orchestration → shared.family folder · role README

MechanismFormMoveModelEnf.Entry
Executable source-of-truth (data-not-code, can't drift) — trunk / methodtyped-irpackagegoverns-a-modelHardexecutable-source-of-truth.md
Drift & parity gates (model↔reality) — trunk / methodvalidationsensorgoverns-a-modelHarddrift-parity-gates.md
Agent-first MBSE harness (frozen records; adopt schema, skip runtime) — trunk / methodtyped-irpackagegoverns-a-modelHardagent-first-mbse-harness.md
Formal invariant verification (temporal form → model check) — trunk / methodvalidationsensorgoverns-a-modelHardformal-invariant-verification.md
Coverage → model-node mapping (which invariants are tested) — trunk / methodvalidationsensorgoverns-a-modelSoft·Hardcoverage-model-mapping.md
Journey-criticality → test-tier placement (which host a test runs on) — trunk / methodvalidationpackagegoverns-a-modelSoft·Hardjourney-criticality-test-placement.md
Journey task-closure (typed terminal post-condition → derived strength) — trunk / methodvalidationpackagegoverns-a-modelSoft·Hardjourney-task-closure.md
Invariant-DAG execution policy (typed Scheduler: correctness vs resource + cost) — trunk / methodtyped-irpackagegoverns-a-modelSoft·Hardinvariant-dag-execution-policy.md
Model-driven codegen — trunk / methodvalidationsensorgoverns-a-modelHardmodel-driven-codegen.md
Model query surface (repo-query) — trunk / methodagent-outputconstraintgoverns-a-modelSoftquery-surface.md
Meta-model consumption (read, don't hardcode) — trunk / methodtyped-irconstraintgoverns-a-modelHardmeta-model-consumption.md
Control↔substrate dependency (computed blast-radius) — trunk / methodtyped-irpackageis-a-modelHardcontrol-substrate-dependency.md
Symbol-anchored traceability graph (derived edges) — trunk / methodtyped-irpackageis-a-modelHardsymbol-anchored-traceability-graph.md
Model-graded finding severity (distance-graded gate) — trunk / methodquality-gatesensorgoverns-a-modelHardmodel-graded-finding-severity.md
Model-derived test-obligation census (derive obligations, lint the gap) — trunk / methodvalidationsensorgoverns-a-modelHardmodel-derived-test-obligation-census.md
Control-coverage census (controls per governance target) — trunk / methodvalidationsensorgoverns-a-modelSoft·Hardcontrol-coverage-census.md
Orphan-coverage metric (walk code → governance; score the un-covered remainder) — trunk / methodvalidationsensorgoverns-a-modelSoftorphan-coverage-metric.md
Service-flow / API model — product-facingtyped-irpackageis-a-modelHardservice-flow-model.md
User-journey model (product-goal → implementation) — product-facingtyped-irpackageis-a-modelHarduser-journey-model.md
Domain registries — product-facingtyped-irpackageis-a-modelHarddomain-registries.md
Composed state-machine model (typed lifecycles + cross-machine invariants) — product-facingtyped-irpackageis-a-modelHardcomposed-state-machine-model.md
Process view (concurrent processes, lanes, racing edges) — product-facingtyped-irpackageis-a-modelHardprocess-view.md
Typed contract surfaces (checked boundary, not a comment) — product-facingtyped-irpackageis-a-modelHardtyped-contract-surfaces.md
Compliance data-flow model (typed sinks & edges for privacy) — product-facingtyped-irpackageis-a-modelHarddata-flow-model.md
Timeout-budget ordering model (nested wall-clock budgets, checked) — product-facingtyped-irpackageis-a-modelHardtimeout-budget-ordering-model.md
Required-config-per-role manifest (admission on complete env) — product-facingtyped-irpackageis-a-modelHardrequired-config-per-role-manifest.md
Telemetry-collection provenance (origin · landing · per-env coverage) — product-facingtyped-irpackageis-a-modelHardtelemetry-collection-provenance.md
Rule-metadata registry (queryable governance metadata) — product-facingtyped-irpackageis-a-modelHardrule-metadata-registry.md
Synchronization model (meta-sync) — orchestration-facingtyped-irpackageis-a-modelHardsynchronization-model.md
Agent-orchestration model (developer journeys) — orchestration-facingtyped-irpackageis-a-modelHardagent-orchestration-model.md
Governance graph (mechanism-interaction model) — orchestration-facingtyped-irpackageis-a-modelSoft·Hardgovernance-graph.md
Lifecycle model (typed operational map → generated runbook) — orchestration-facingtyped-irpackageis-a-modelHardlifecycle-model.md
Component & zone model — shared spinetyped-irpackageis-a-modelHardcomponent-zone-model.md
Mediator & single-writer contracts — shared spinetyped-irpackageis-a-modelHardconcurrency-contracts.md
Deployment & tier topology — shared spinetyped-irpackageis-a-modelHarddeployment-topology-model.md

Product target

7. Canonical models & seams

The one sanctioned typed model or seam per concern, each held in place by a ban-lint.family folder

MechanismFormMoveModelEnf.Entry
PdfModel (sole PDF mutation surface)typed-irpackageis-a-modelHardpdf-model.md
Office Models ({Slides,Docs,Sheets}Model)typed-irpackageis-a-modelHardoffice-models.md
ServiceClient (typed cross-service seam)bounded-serviceconstraintHardservice-client.md
Canonical walkers (one traversal per tree)typed-irpackageis-a-modelHardcanonical-walkers.md
Sole raw-Redis seam (the dispatch module)bounded-serviceconstraintHardraw-redis-seam.md

8. Validation & conformance

Deterministic pass/fail checks over the artifact.family folder

MechanismFormMoveModelEnf.Entry
ContentValidator (input ⊆ output fidelity)validationsensorHardcontent-validator.md
Blocking semantic lintsvalidationsensorHardsemantic-lints.md
Standards / WCAG rule enginevalidationsensorHardstandards-rule-engine.md
Cross-source coherence lintsvalidationsensorHardcoherence-lints.md

9. Regression tests

Repeatable behaviour-pinning bodies.family folder

MechanismFormMoveModelEnf.Entry
Test-onion tiers (Smoke / Lite / targeted / full)regressionsensorHardtest-onion-tiers.md
FsCheck property testsregressionsensorHardproperty-tests.md
Fuzz campaigns (+ auto-coverage)regressionsensorHardfuzz-campaigns.md
DDT pin-trailersregressionsensorHardddt-pin-trailers.md

10. Provenance & attribution

Durable records of what the tool changed.family folder

MechanismFormMoveModelEnf.Entry
Per-mutator attribution stampsaudit-trailsensorHard (audit)mutator-stamps.md
F10 mutator-stamp-wiring lintvalidationsensorgoverns-a-modelHardf10-wiring-lint.md
derive-changelog (reconstruct mutations)audit-trailsensorHard (audit)derive-changelog.md
a11y_ prefix conventionrepair-vocabconstraintHarda11y-prefix.md

11. Repair vocabulary

The bounded move-space of the remediator.family folder

MechanismFormMoveModelEnf.Entry
Typed ViolationCategory / FailureCategory enumsrepair-vocabconstraintHardtyped-categories.md
Closed remediation-verb setsrepair-vocabconstraintHardremediation-verbs.md
Codemod-first threshold (N≳50 → AST transformer)repair-vocabconstraintSoftcodemod-first.md

Three roles complete — 85 mechanisms across 11 families, all fully developed. Agent (30): Context & dispatch (4) · Gates & merge-train (4) · Mediators & resource locks (4) · Lifecycle & observability (8) · Governance-doc mechanisms (10, incl. the CLAUDE.md rule index meta-mechanism and the self-governance conversion loop). Models-bridge (35): the MBSE method (17 subject-agnostic mechanisms, incl. formal temporal-logic verification, coverage→model-node mapping, journey-criticality → test-tier placement, journey task-closure, invariant-DAG execution policy, computed control↔substrate blast-radius, the per-target control-coverage census, + the symbol-anchored traceability graph) reified as a Y over 18 models — product-facing 5 (service-flow · user-journey · domain-registries · composed-state-machine · process-view) · orchestration-facing 4 (synchronization · agent-orch · governance-graph · lifecycle) · shared-spine 3 (component-zone · concurrency · deployment, both faces); the MBSE substrate through which a bounded agent operates an unbounded codebase. These model entries are a curated sample of the portable genres — the substrate carries on the order of sixty typed models, and these cover the ones whose shape transfers. Product (20): Canonical models & seams (5) · Validation & conformance (4) · Regression tests (4) · Provenance & attribution (4) · Repair vocabulary (3).