archctx 0.1.2 → 0.1.4-beta.0

package/NOTICE.md

@@ -0,0 +1,23 @@
+# archctx Notices
+
+This package includes curated architecture practice assets. The source registry bundled in `assets/sources/` is the authoritative provenance record.
+
+- Structurizr DSL Documentation (structurizr.dsl): LicenseRef-Structurizr-Docs; Structurizr DSL documentation; revision pinned-reference-2026-06-24.
+- The Twelve-Factor App (twelve-factor): MIT; The Twelve-Factor App contributors; revision pinned-reference-2026-06-24.
+- Kubernetes Documentation (kubernetes.docs): CC-BY-4.0; Kubernetes documentation contributors; revision pinned-reference-2026-06-24.
+- CNCF TAG App Delivery (cncf.app-delivery): Apache-2.0; CNCF TAG App Delivery contributors; revision pinned-reference-2026-06-24.
+- Google SRE Book (google.sre): CC-BY-NC-ND-4.0; Google SRE Book authors; revision pinned-reference-2026-06-24.
+- Azure Architecture Center (azure.architecture): LicenseRef-Microsoft-Docs; Microsoft Learn documentation; revision pinned-reference-2026-06-24.
+- OWASP Cheat Sheet Series (owasp.cheat-sheet-series): CC-BY-SA-4.0; OWASP Cheat Sheet Series contributors; revision pinned-reference-2026-06-24.
+- arc42 Template (arc42): CC-BY-SA-4.0; arc42 contributors; revision pinned-reference-2026-06-24.
+- ArchContext Product Specification (archcontext.spec): LicenseRef-ArchContext-Repo; ArchContext maintainers; revision 2026-06-23.
+- ADR-0008 Declared Observed Verified (archcontext.adr.0008): LicenseRef-ArchContext-Repo; ArchContext maintainers; revision 2026-06-23.
+- ADR-0009 Target State vs Migration State (archcontext.adr.0009): LicenseRef-ArchContext-Repo; ArchContext maintainers; revision 2026-06-23.
+- ADR-0010 Compatibility Code Requires Contract (archcontext.adr.0010): LicenseRef-ArchContext-Repo; ArchContext maintainers; revision 2026-06-23.
+- ADR-0012 Changeset-only Architecture Writes (archcontext.adr.0012): LicenseRef-ArchContext-Repo; ArchContext maintainers; revision 2026-06-23.
+- ADR-0036 Deterministic Gate LLM Advisory (archcontext.adr.0036): LicenseRef-ArchContext-Repo; ArchContext maintainers; revision 2026-06-23.
+- Markdown Architectural Decision Records (madr): MIT OR CC0-1.0; MADR contributors; revision v4.0.0.
+- Backstage Software Catalog (backstage): Apache-2.0; Backstage contributors; revision pinned-reference.
+- ArchUnit (archunit): Apache-2.0; ArchUnit contributors; revision pinned-reference.
+- OpenTelemetry Documentation (opentelemetry): CC-BY-4.0; OpenTelemetry contributors; revision pinned-reference.
+- OpenSSF Scorecard (openssf.scorecard): Apache-2.0; OpenSSF Scorecard contributors; revision pinned-reference.

package/assets/README.md

@@ -0,0 +1,15 @@
+# Practice Catalog Assets
+
+Built-in assets use `.yaml` files containing the JSON-compatible YAML subset.
+The loader intentionally keeps parsing strict in the first release so catalog
+digests stay stable across operating systems and formatter changes.
+
+Authoring rules:
+
+- Every practice is original ArchContext guidance, not copied source text.
+- Every source reference must exist under `sources/`.
+- Candidate terms are recall hints only; enforcement requires deterministic
+  checks and repository opt-in.
+- Built-in assets default to advisory.
+- Repo overlays live under `.archcontext/practices/` and must use
+  `overlay.mode` for `replace` or `disable`.

package/assets/catalog.yaml

@@ -0,0 +1,393 @@
+{
+  "schemaVersion": "archcontext.practice-catalog-manifest/v1",
+  "catalogVersion": "2026.06.0",
+  "productVersion": "0.1.4-beta.0",
+  "generatedAt": "1970-01-01T00:00:00.000Z",
+  "entries": [
+    {
+      "id": "api.backward-compatible-error-shape",
+      "revision": 1,
+      "digest": "sha256:6c8449b8ed749dd799a0b18c7c18e5bd7419ee023ceb39220a4a5d14497620bc",
+      "sourceIds": [
+        "archcontext.adr.0010",
+        "twelve-factor"
+      ]
+    },
+    {
+      "id": "api.contract-before-implementation",
+      "revision": 1,
+      "digest": "sha256:feda012bf57e5d3b8cef58fc1f9a7d8a44a4f894325f294dc91e3eec5cc01274",
+      "sourceIds": [
+        "archcontext.adr.0012"
+      ]
+    },
+    {
+      "id": "api.idempotency-contract",
+      "revision": 1,
+      "digest": "sha256:f0227e27220720c3def141cb7ec0a52279e88a231ec16d6907831718f129b609",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "twelve-factor"
+      ]
+    },
+    {
+      "id": "api.schema-version-contract",
+      "revision": 1,
+      "digest": "sha256:558ffdcbe6bda5bbdeec983b94ee01228a5bb155d20c7e70a8bef3e658521930",
+      "sourceIds": [
+        "archcontext.adr.0012",
+        "structurizr.dsl"
+      ]
+    },
+    {
+      "id": "compatibility.deprecation-window",
+      "revision": 1,
+      "digest": "sha256:040265971f79b54d451146fab43f3a46373b17ef6f9a947753b64b4b9531a8f1",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "archcontext.adr.0010"
+      ]
+    },
+    {
+      "id": "compatibility.expiry-contract",
+      "revision": 1,
+      "digest": "sha256:fac35fddef8cc263ea8af18052c2ceae86484f340192c84b2358c130bf16d411",
+      "sourceIds": [
+        "archcontext.adr.0010"
+      ]
+    },
+    {
+      "id": "compatibility.rollback-entrypoint",
+      "revision": 1,
+      "digest": "sha256:40bccd9b8691221ba3dfc443dcdf41181f4ffd31162460054c01cfa85df8d363",
+      "sourceIds": [
+        "azure.architecture",
+        "twelve-factor"
+      ]
+    },
+    {
+      "id": "compatibility.single-owner",
+      "revision": 1,
+      "digest": "sha256:10cd2ee205eb6440efb12cb88d6e4256f90bb71e575a51a2c8eb0912da1ae4b3",
+      "sourceIds": [
+        "archcontext.adr.0010",
+        "madr"
+      ]
+    },
+    {
+      "id": "data.event-version-lineage",
+      "revision": 1,
+      "digest": "sha256:cca5d1661791d76f7eaf4eb0afa8a98958ac2bf9de9e4e02f33ef2a6b9203a3d",
+      "sourceIds": [
+        "archcontext.adr.0010",
+        "kubernetes.docs"
+      ]
+    },
+    {
+      "id": "data.migration-backfill-evidence",
+      "revision": 1,
+      "digest": "sha256:12f11757903e72fb3839a9901b2aa950399f9a21b42a4d5e6ac04e32550c50b0",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "opentelemetry"
+      ]
+    },
+    {
+      "id": "data.schema-ownership-boundary",
+      "revision": 1,
+      "digest": "sha256:0173e7cf21315602254df946eabf36ff48e0daae175da0ac896ce236b990f902",
+      "sourceIds": [
+        "archcontext.adr.0008",
+        "backstage"
+      ]
+    },
+    {
+      "id": "data.single-authoritative-model",
+      "revision": 1,
+      "digest": "sha256:3aa691d353de1c5c7949d46fb222791fc95ec5974f0b902354672d1e769ae04e",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "archcontext.spec"
+      ]
+    },
+    {
+      "id": "decision.decision-review-date",
+      "revision": 1,
+      "digest": "sha256:66e27ef86c399ff45984826386e1eca9e183b848839d92644bd1def230f41341",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "madr"
+      ]
+    },
+    {
+      "id": "decision.record-significant-change",
+      "revision": 1,
+      "digest": "sha256:d95b84a2a42979a81158b523c8fa4975d3b98fdc500cfee570a55b92cd60acab",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "madr"
+      ]
+    },
+    {
+      "id": "decision.supersession-link",
+      "revision": 1,
+      "digest": "sha256:ccd67b3bf3b0642757c907a1b2c5c28a2ce88d49838a6b814e4cea280efabc91",
+      "sourceIds": [
+        "archcontext.adr.0012",
+        "madr"
+      ]
+    },
+    {
+      "id": "decision.tradeoff-options-recorded",
+      "revision": 1,
+      "digest": "sha256:1027090dcc8a87dcc647cdf905ab8f8fa72b462d602ff645ea538c51dd677a27",
+      "sourceIds": [
+        "archcontext.adr.0012",
+        "madr"
+      ]
+    },
+    {
+      "id": "migration.backfill-reconciliation",
+      "revision": 1,
+      "digest": "sha256:8a0eeb42bebb5abdaacd0a97d15a3e07bd1c846c7514e03e8a85f5a1cb3eb73d",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "archcontext.spec"
+      ]
+    },
+    {
+      "id": "migration.parallel-run-observability",
+      "revision": 1,
+      "digest": "sha256:2a4db10fa9b3eea976aa5c88c118146903eb3cda606c211008c45d98e1ddf6b1",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "opentelemetry"
+      ]
+    },
+    {
+      "id": "migration.rollback-plan",
+      "revision": 1,
+      "digest": "sha256:2948186128975b08ad8164c630d4ae7f5f7c36d43b1b1279809e3b785080e297",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "azure.architecture"
+      ]
+    },
+    {
+      "id": "migration.target-and-removal-state",
+      "revision": 1,
+      "digest": "sha256:d2803800c9deb288113e5f087c96e35bb45d9f2dae0d8a9350e1434f7369cd7e",
+      "sourceIds": [
+        "archcontext.adr.0009",
+        "madr"
+      ]
+    },
+    {
+      "id": "modularity.layer-contract-declared",
+      "revision": 1,
+      "digest": "sha256:9f48437f90e17c6b518983e6f305022db0c18c7a7b5beb17a4cff5df57824bae",
+      "sourceIds": [
+        "archunit",
+        "structurizr.dsl"
+      ]
+    },
+    {
+      "id": "modularity.no-new-cycle",
+      "revision": 1,
+      "digest": "sha256:411e860fd6ddbfd12dc6dd2a90a09f618d64842efbe0fd08b01f6e12ef98038e",
+      "sourceIds": [
+        "archunit"
+      ]
+    },
+    {
+      "id": "modularity.no-shared-internal-imports",
+      "revision": 1,
+      "digest": "sha256:19e99f0c9bc10ad6c96c219021f865191a05c6c3bcd38ae4ee0d9ad61de43332",
+      "sourceIds": [
+        "archcontext.adr.0012",
+        "archunit"
+      ]
+    },
+    {
+      "id": "modularity.respect-dependency-direction",
+      "revision": 1,
+      "digest": "sha256:b14a5f8d63aa306bb275e2de6c282856347579dcddad2c9728fdfd87662f8623",
+      "sourceIds": [
+        "archcontext.spec",
+        "archunit"
+      ]
+    },
+    {
+      "id": "observability.boundary-telemetry",
+      "revision": 1,
+      "digest": "sha256:350c5a53f961911d9f29131f38ebdfacc099e05554c8e1ce0b23e9b0152fa105",
+      "sourceIds": [
+        "opentelemetry"
+      ]
+    },
+    {
+      "id": "observability.error-budget-signal",
+      "revision": 1,
+      "digest": "sha256:af034b7c1fee1653d551a710f155d48a0094ca3917779476b70529b9d23ed40d",
+      "sourceIds": [
+        "azure.architecture",
+        "opentelemetry"
+      ]
+    },
+    {
+      "id": "observability.queue-boundary-metrics",
+      "revision": 1,
+      "digest": "sha256:5323893611436bd10f21565731c3338f6e8fa8500bdab321ba1d3389b10fc427",
+      "sourceIds": [
+        "cncf.app-delivery",
+        "opentelemetry"
+      ]
+    },
+    {
+      "id": "observability.release-health-probe",
+      "revision": 1,
+      "digest": "sha256:eb5e957beea83b88b4edfb6e265c2f62fe35a69402799304f4abab87f59115d0",
+      "sourceIds": [
+        "kubernetes.docs",
+        "opentelemetry"
+      ]
+    },
+    {
+      "id": "ownership.escalation-contact",
+      "revision": 1,
+      "digest": "sha256:610f39e8e67e37abdc2b78079cef59c04adcbdbcc2773e69c5b703ddbf80b0fa",
+      "sourceIds": [
+        "backstage",
+        "cncf.app-delivery"
+      ]
+    },
+    {
+      "id": "ownership.explicit-lifecycle-owner",
+      "revision": 1,
+      "digest": "sha256:c0ba742d5ff505305292fb6cd508d27bbabe94e2ba045b316ace4e783d16944e",
+      "sourceIds": [
+        "archcontext.spec",
+        "backstage"
+      ]
+    },
+    {
+      "id": "ownership.operational-owner",
+      "revision": 1,
+      "digest": "sha256:d8fdacf11a8e9ee2e46eaf9a78f57a3b6d66c057e8a2bfcac29b3faac09a1f8f",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "backstage"
+      ]
+    },
+    {
+      "id": "ownership.service-catalog-entry",
+      "revision": 1,
+      "digest": "sha256:59d5562970fd857087bcf6243391b980d8d0d13f36be4396dc7af54b5a5f8197",
+      "sourceIds": [
+        "archcontext.spec",
+        "backstage"
+      ]
+    },
+    {
+      "id": "security.audit-log-redaction",
+      "revision": 1,
+      "digest": "sha256:921d52cfaa2d2a39ae1bd37c630ef55eef6a6f1248ddb23cbf4ece54cc7105db",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "archcontext.spec"
+      ]
+    },
+    {
+      "id": "security.external-permission-review",
+      "revision": 1,
+      "digest": "sha256:5dafe3a89389bfb95e75db79afe58d9894dd51c8fe02fd5a3756c47dc6ac4a59",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "openssf.scorecard"
+      ]
+    },
+    {
+      "id": "security.least-privilege",
+      "revision": 1,
+      "digest": "sha256:cd6ac2258d32c3df30427c62762cfc58e64cca74087e7e54455eecde54f89f08",
+      "sourceIds": [
+        "archcontext.adr.0036"
+      ]
+    },
+    {
+      "id": "security.secret-material-never-enters-repo",
+      "revision": 1,
+      "digest": "sha256:0fd56ae3c4ee17575d9bb42af31d8a2febee4ba98b34fe3be56c4deb9e770cb1",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "openssf.scorecard"
+      ]
+    },
+    {
+      "id": "security.secret-redaction-old",
+      "revision": 1,
+      "digest": "sha256:14a71e065a55da1b7b8c4cdb24d15960d4ccd9fa5d5dcc36b2f185695bb02bd9",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "openssf.scorecard"
+      ]
+    },
+    {
+      "id": "supply-chain.dependency-update-review",
+      "revision": 1,
+      "digest": "sha256:6c7e92c1a9f898fc2eb771f083403b6289b01d125df3d56dd1391efca8845524",
+      "sourceIds": [
+        "archcontext.adr.0036",
+        "openssf.scorecard"
+      ]
+    },
+    {
+      "id": "supply-chain.pinned-dependencies",
+      "revision": 1,
+      "digest": "sha256:d091497c904baa5bc010eb77fbea202b5f3700ec9a0d5ee45db6d34c8a61e82b",
+      "sourceIds": [
+        "openssf.scorecard"
+      ]
+    },
+    {
+      "id": "supply-chain.release-artifact-digest",
+      "revision": 1,
+      "digest": "sha256:7b417cb099ae7c0d52193835bf9453380f374beb08feebf1d6aa3a194538e0ba",
+      "sourceIds": [
+        "openssf.scorecard",
+        "twelve-factor"
+      ]
+    },
+    {
+      "id": "supply-chain.sbom-manifest",
+      "revision": 1,
+      "digest": "sha256:c46fc62568baa386231f4ab57d311cdf2706c12b3f179e9a859c45b6d7e14f70",
+      "sourceIds": [
+        "cncf.app-delivery",
+        "openssf.scorecard"
+      ]
+    }
+  ],
+  "sourceIds": [
+    "arc42",
+    "archcontext.adr.0008",
+    "archcontext.adr.0009",
+    "archcontext.adr.0010",
+    "archcontext.adr.0012",
+    "archcontext.adr.0036",
+    "archcontext.spec",
+    "archunit",
+    "azure.architecture",
+    "backstage",
+    "cncf.app-delivery",
+    "google.sre",
+    "kubernetes.docs",
+    "madr",
+    "openssf.scorecard",
+    "opentelemetry",
+    "owasp.cheat-sheet-series",
+    "structurizr.dsl",
+    "twelve-factor"
+  ],
+  "catalogDigest": "sha256:19c4fdf4068eaf19f782d92373354cff071947134e76eb6927998d5a9a1146c3"
+}

package/assets/practices/api.contract-before-implementation.yaml

@@ -0,0 +1,70 @@
+{
+  "schemaVersion": "archcontext.practice/v1",
+  "id": "api.contract-before-implementation",
+  "revision": 1,
+  "status": "active",
+  "title": "API boundary changes should update the contract before implementation",
+  "summary": "A public API, event, or integration boundary should have its contract updated before downstream implementation details depend on it.",
+  "category": "api",
+  "tags": ["api", "contract", "boundary"],
+  "appliesTo": {
+    "repositoryKinds": ["application", "service", "library"],
+    "languages": [],
+    "frameworks": [],
+    "pathGlobs": ["src/**", "packages/**", "schemas/**"],
+    "nodeKinds": ["public-api", "service", "module"],
+    "negativePathGlobs": ["test/**", "docs/**"]
+  },
+  "triggers": {
+    "candidateTerms": ["api", "contract", "schema", "event", "public"],
+    "pressureSignals": ["contract-after-implementation"],
+    "structuralPredicates": ["public-api-changed", "schema-contract-missing"]
+  },
+  "evidencePolicy": {
+    "minimumStrengthForRecommendation": "declared",
+    "minimumStrengthForCheckpoint": "observed",
+    "minimumStrengthForEnforcement": "observed",
+    "requiredKindsForEnforcement": ["diff", "path", "test"],
+    "maxEnforcementWhenOnlyHeuristic": "advisory"
+  },
+  "guidance": {
+    "questions": ["Which consumer sees this boundary?", "Where is the contract versioned?", "What compatibility test proves the shape?"],
+    "preferred": ["Change the schema or contract in the same slice.", "Keep implementation and contract reviewable together."],
+    "avoid": ["Implementing first and documenting later.", "Letting tests be the only public contract."]
+  },
+  "checks": [
+    {
+      "checkId": "required-test-evidence",
+      "mode": "deterministic",
+      "parameters": {
+        "scope": "public-api"
+      }
+    }
+  ],
+  "enforcement": {
+    "default": "advisory",
+    "promotableTo": "complete",
+    "repoOptInRequired": true,
+    "fixtureGate": {
+      "positive": [{ "id": "fixture.api.contract-before-implementation.positive", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Policy-declared test evidence can satisfy complete enforcement." }],
+      "nearNegative": [{ "id": "fixture.api.contract-before-implementation.near-negative", "path": "evals/practices/benign-negative.jsonl", "description": "Benign API wording does not become complete enforcement." }],
+      "mixedChange": [{ "id": "fixture.api.contract-before-implementation.mixed-change", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Partial command-only evidence still fails the required subject proof." }],
+      "baseline": [{ "id": "fixture.api.contract-before-implementation.baseline", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Policy-declared test evidence is evaluated against explicit match subjects." }]
+    }
+  },
+  "provenance": {
+    "sourceKind": "archcontext-native",
+    "sourceRefs": [
+      {
+        "sourceId": "archcontext.adr.0012"
+      }
+    ],
+    "curator": "archcontext-maintainers",
+    "reviewedAt": "2026-06-23"
+  },
+  "lifecycle": {
+    "introducedAt": "2026-06-23",
+    "reviewAfter": "2027-06-23",
+    "supersedes": []
+  }
+}

package/assets/practices/compatibility.expiry-contract.yaml

@@ -0,0 +1,71 @@
+{
+  "schemaVersion": "archcontext.practice/v1",
+  "id": "compatibility.expiry-contract",
+  "revision": 1,
+  "status": "active",
+  "title": "Temporary compatibility needs an expiry contract",
+  "summary": "A temporary compatibility path must name its durable reason, review date, and deletion condition before it can become governed code.",
+  "category": "compatibility",
+  "tags": ["compatibility", "expiry", "cleanup"],
+  "appliesTo": {
+    "repositoryKinds": ["application", "service", "library"],
+    "languages": [],
+    "frameworks": [],
+    "pathGlobs": ["**/*"],
+    "nodeKinds": ["module", "service", "public-api"],
+    "negativePathGlobs": ["test/**", "docs/**"]
+  },
+  "triggers": {
+    "candidateTerms": ["temporary", "compatibility", "fallback", "cleanup later", "legacy"],
+    "pressureSignals": ["unbounded-compatibility-path"],
+    "structuralPredicates": ["compatibility-path-added", "cleanup-contract-missing"]
+  },
+  "evidencePolicy": {
+    "minimumStrengthForRecommendation": "heuristic",
+    "minimumStrengthForCheckpoint": "observed",
+    "minimumStrengthForEnforcement": "observed",
+    "requiredKindsForEnforcement": ["diff", "architecture-model"],
+    "maxEnforcementWhenOnlyHeuristic": "advisory"
+  },
+  "guidance": {
+    "questions": ["When can this code be removed?", "What proof closes the compatibility window?", "Who reviews it if the date passes?"],
+    "preferred": ["Use a dated removal condition and owner.", "Keep compatibility logic at one boundary."],
+    "avoid": ["Open-ended temporary branches.", "Cleanup notes with no owner or date."]
+  },
+  "checks": [
+    {
+      "checkId": "compatibility-contract-required",
+      "mode": "deterministic",
+      "parameters": {
+        "requireRemovalCondition": true,
+        "requireReviewDate": true
+      }
+    }
+  ],
+  "enforcement": {
+    "default": "advisory",
+    "promotableTo": "complete",
+    "repoOptInRequired": true,
+    "fixtureGate": {
+      "positive": [{ "id": "fixture.compatibility.expiry-contract.positive", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Invalid or vague expiry evidence blocks complete enforcement." }],
+      "nearNegative": [{ "id": "fixture.compatibility.expiry-contract.near-negative", "path": "evals/practices/benign-negative.jsonl", "description": "General compatibility wording remains advisory without scoped evidence." }],
+      "mixedChange": [{ "id": "fixture.compatibility.expiry-contract.mixed-change", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Mixed migration evidence distinguishes review date from removal condition." }],
+      "baseline": [{ "id": "fixture.compatibility.expiry-contract.baseline", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Complete migration evidence passes with stable baseline subjects." }]
+    }
+  },
+  "provenance": {
+    "sourceKind": "archcontext-native",
+    "sourceRefs": [
+      {
+        "sourceId": "archcontext.adr.0010"
+      }
+    ],
+    "curator": "archcontext-maintainers",
+    "reviewedAt": "2026-06-23"
+  },
+  "lifecycle": {
+    "introducedAt": "2026-06-23",
+    "reviewAfter": "2027-06-23",
+    "supersedes": []
+  }
+}

package/assets/practices/compatibility.single-owner.yaml

@@ -0,0 +1,78 @@
+{
+  "schemaVersion": "archcontext.practice/v1",
+  "id": "compatibility.single-owner",
+  "revision": 1,
+  "status": "active",
+  "title": "Compatibility paths require one lifecycle owner",
+  "summary": "A compatibility path must have one accountable owner, a durable reason, a removal condition, and a bounded review date.",
+  "category": "compatibility",
+  "tags": ["compatibility", "migration", "lifecycle"],
+  "appliesTo": {
+    "repositoryKinds": ["application", "service", "library"],
+    "languages": [],
+    "frameworks": [],
+    "pathGlobs": ["**/*"],
+    "nodeKinds": ["module", "service", "public-api"],
+    "negativePathGlobs": ["test/**", "**/*.fixture.*"]
+  },
+  "triggers": {
+    "candidateTerms": ["compatibility", "legacy", "fallback", "adapter", "v1", "v2"],
+    "pressureSignals": ["unjustified-wrapper-adapter", "dual-track-business-concept"],
+    "structuralPredicates": ["compatibility-path-added", "parallel-public-api-observed"]
+  },
+  "evidencePolicy": {
+    "minimumStrengthForRecommendation": "heuristic",
+    "minimumStrengthForCheckpoint": "observed",
+    "minimumStrengthForEnforcement": "observed",
+    "requiredKindsForEnforcement": ["diff", "symbol"],
+    "maxEnforcementWhenOnlyHeuristic": "advisory"
+  },
+  "guidance": {
+    "questions": ["Who owns the compatibility path through removal?", "What external contract or persisted state requires it?", "What exact condition allows deletion?"],
+    "preferred": ["Adapt at one boundary and keep one internal representation.", "Record owner, review date, tests, and removal condition."],
+    "avoid": ["Maintaining v1/v2 branches in multiple business layers.", "Permanent fallback code with a generic cleanup note."]
+  },
+  "checks": [
+    {
+      "checkId": "compatibility-contract-required",
+      "mode": "deterministic",
+      "parameters": {
+        "requireOwner": true,
+        "requireRemovalCondition": true,
+        "requireReviewDate": true,
+        "requireTests": true
+      }
+    }
+  ],
+  "enforcement": {
+    "default": "advisory",
+    "promotableTo": "complete",
+    "repoOptInRequired": true,
+    "fixtureGate": {
+      "positive": [{ "id": "fixture.compatibility.single-owner.positive", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Missing durable compatibility contract blocks complete enforcement." }],
+      "nearNegative": [{ "id": "fixture.compatibility.single-owner.near-negative", "path": "evals/practices/benign-negative.jsonl", "description": "Heuristic legacy wording cannot become a complete violation." }],
+      "mixedChange": [{ "id": "fixture.compatibility.single-owner.mixed-change", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Mixed source and test changes keep eligible subjects scoped." }],
+      "baseline": [{ "id": "fixture.compatibility.single-owner.baseline", "path": "packages/core/practice-engine/test/practice-engine.test.ts", "description": "Previous checkpoint match keeps historical compatibility paths from appearing new." }]
+    }
+  },
+  "provenance": {
+    "sourceKind": "archcontext-native",
+    "sourceRefs": [
+      {
+        "sourceId": "archcontext.adr.0010"
+      },
+      {
+        "sourceId": "madr",
+        "sourceRevision": "v4.0.0",
+        "licenseSpdx": "MIT OR CC0-1.0"
+      }
+    ],
+    "curator": "archcontext-maintainers",
+    "reviewedAt": "2026-06-23"
+  },
+  "lifecycle": {
+    "introducedAt": "2026-06-23",
+    "reviewAfter": "2027-06-23",
+    "supersedes": []
+  }
+}