kyle-sexton · Oct 30, 2026 · Oct 29, 2026 · Oct 29, 2026 · Oct 29, 2026 · Oct 29, 2026
diff --git a/.lycheeignore b/.lycheeignore
@@ -89,6 +89,3 @@ github\.com/meridian-labs/agent-cli/releases/tag/
 ^https://api\.github\.com/repos/anthropics/claude-code/releases$
 ^https://api\.github\.com/repos/anthropics/claude-code/releases/tags/v2\.1\.269$
 ^https://api\.github\.com/repos/anthropics/claude-code/tags$
-
-# TEMPORARY (#7537): local links to the plugin-author contracts that moved from docs/conventions/<name>/ to docs/contracts/<name>/ dangle until the old-path stubs land; the stubs change removes this entry.
-^file://.*/docs/conventions/(argument-hint|authoring-formats|check-placement|commit-convention|config-cascade|consumer-config-layering|detector-findings|ecosystem-commands|enforcement-ladder|execution-target|finding-suppression|hook-budget|hook-config-delivery|hook-input-rewriting|hook-observability|hook-precision|hook-telemetry|instruction-exception-register|invocation-context|invocation-mode|liveness-assertion|loop-lane|mod-authoring|native-references|on-demand-dependencies|permission-rule-hygiene|plugin-data-report-keying|plugin-option-naming|plugin-reconfiguration|pr-body-convention|pr-scope-budget|pre-pr-ordering|prerequisites|recommendation-basis|record-bundle|rendered-views|retired-conventions|routing-as-data|seam-phrasing|setup-lifecycle|shell-test-helpers|skill-argument-shape|standards|tracker-reference-form|untrusted-content|upstream-drift|windows-path-emit|workspace-environment)(/|#|$)
diff --git a/docs/conventions/argument-hint/README.md b/docs/conventions/argument-hint/README.md
@@ -0,0 +1,40 @@
+# Skill argument-hint house style
+
+This contract moved to [`docs/contracts/argument-hint/`](../../contracts/argument-hint/README.md). This page keeps its
+headings so links from installed plugin versions still reach each section.
+
+## What the field is
+
+Moved to [this section](../../contracts/argument-hint/README.md#what-the-field-is).
+
+## Official and house rules
+
+Moved to [this section](../../contracts/argument-hint/README.md#official-and-house-rules).
+
+## Notation
+
+Moved to [this section](../../contracts/argument-hint/README.md#notation).
+
+## House rules
+
+Moved to [this section](../../contracts/argument-hint/README.md#house-rules).
+
+## Setup skills
+
+Moved to [this section](../../contracts/argument-hint/README.md#setup-skills).
+
+## What a plugin skill cannot show
+
+Moved to [this section](../../contracts/argument-hint/README.md#what-a-plugin-skill-cannot-show).
+
+## Enforcement
+
+Moved to [this section](../../contracts/argument-hint/README.md#enforcement).
+
+## What this convention is not
+
+Moved to [this section](../../contracts/argument-hint/README.md#what-this-convention-is-not).
+
+## Versioning
+
+Moved to [this section](../../contracts/argument-hint/README.md#versioning).
diff --git a/docs/conventions/authoring-formats/README.md b/docs/conventions/authoring-formats/README.md
@@ -0,0 +1,48 @@
+# Authoring formats: acceptance-criteria format and diagram dialect
+
+This contract moved to [`docs/contracts/authoring-formats/`](../../contracts/authoring-formats/README.md). This page keeps its
+headings so links from installed plugin versions still reach each section.
+
+## Boundary
+
+Moved to [this section](../../contracts/authoring-formats/README.md#boundary).
+
+## The keys
+
+Moved to [this section](../../contracts/authoring-formats/README.md#the-keys).
+
+### Why the system key has no default
+
+Moved to [this section](../../contracts/authoring-formats/README.md#why-the-system-key-has-no-default).
+
+### Why mermaid is not offered for the system key
+
+Moved to [this section](../../contracts/authoring-formats/README.md#why-mermaid-is-not-offered-for-the-system-key).
+
+## C4 dialect surfaces
+
+Moved to [this section](../../contracts/authoring-formats/README.md#c4-dialect-surfaces).
+
+## The consumer surface
+
+Moved to [this section](../../contracts/authoring-formats/README.md#the-consumer-surface).
+
+## Resolution ladder
+
+Moved to [this section](../../contracts/authoring-formats/README.md#resolution-ladder).
+
+### Why a skill restates this instead of citing it
+
+Moved to [this section](../../contracts/authoring-formats/README.md#why-a-skill-restates-this-instead-of-citing-it).
+
+## Consumers
+
+Moved to [this section](../../contracts/authoring-formats/README.md#consumers).
+
+## Zero config, including here
+
+Moved to [this section](../../contracts/authoring-formats/README.md#zero-config-including-here).
+
+## Versioning
+
+Moved to [this section](../../contracts/authoring-formats/README.md#versioning).
diff --git a/docs/conventions/check-placement/README.md b/docs/conventions/check-placement/README.md
@@ -0,0 +1,64 @@
+# Check placement: where each automated check runs
+
+This contract moved to [`docs/contracts/check-placement/`](../../contracts/check-placement/README.md). This page keeps its
+headings so links from installed plugin versions still reach each section.
+
+## The rubric
+
+Moved to [this section](../../contracts/check-placement/README.md#the-rubric).
+
+### Formatters
+
+Moved to [this section](../../contracts/check-placement/README.md#formatters).
+
+### Report-only checks
+
+Moved to [this section](../../contracts/check-placement/README.md#report-only-checks).
+
+## The registration contract
+
+Moved to [this section](../../contracts/check-placement/README.md#the-registration-contract).
+
+### Setup surface
+
+Moved to [this section](../../contracts/check-placement/README.md#setup-surface).
+
+### Entry manifest
+
+Moved to [this section](../../contracts/check-placement/README.md#entry-manifest).
+
+### Check-script runtime contract
+
+Moved to [this section](../../contracts/check-placement/README.md#check-script-runtime-contract).
+
+### The skip key: checks.skipmissing
+
+Moved to [this section](../../contracts/check-placement/README.md#the-skip-key-checksskipmissing).
+
+### HookManager port
+
+Moved to [this section](../../contracts/check-placement/README.md#hookmanager-port).
+
+### Where installed copies live
+
+Moved to [this section](../../contracts/check-placement/README.md#where-installed-copies-live).
+
+### Drift: the content-hash stamp
+
+Moved to [this section](../../contracts/check-placement/README.md#drift-the-content-hash-stamp).
+
+### Tests
+
+Moved to [this section](../../contracts/check-placement/README.md#tests).
+
+## typos-format pilot (2026-10-15)
+
+Moved to [this section](../../contracts/check-placement/README.md#typos-format-pilot-2026-10-15).
+
+## Duration budgets
+
+Moved to [this section](../../contracts/check-placement/README.md#duration-budgets).
+
+### Measured rows
+
+Moved to [this section](../../contracts/check-placement/README.md#measured-rows).
diff --git a/docs/conventions/check-placement/adopting-git-hooks.md b/docs/conventions/check-placement/adopting-git-hooks.md
@@ -0,0 +1,3 @@
+# Adopting the git-hook entries
+
+Moved to [`docs/contracts/check-placement/adopting-git-hooks.md`](../../contracts/check-placement/adopting-git-hooks.md).
diff --git a/docs/conventions/commit-convention/README.md b/docs/conventions/commit-convention/README.md
@@ -0,0 +1,24 @@
+# Commit-convention enforcement seam
+
+This contract moved to [`docs/contracts/commit-convention/`](../../contracts/commit-convention/README.md). This page keeps its
+headings so links from installed plugin versions still reach each section.
+
+## Two reads of one file
+
+Moved to [this section](../../contracts/commit-convention/README.md#two-reads-of-one-file).
+
+## The parse contract
+
+Moved to [this section](../../contracts/commit-convention/README.md#the-parse-contract).
+
+## The neutral convention SSOT (convention_source)
+
+Moved to [this section](../../contracts/commit-convention/README.md#the-neutral-convention-ssot-convention_source).
+
+## Two governing contracts
+
+Moved to [this section](../../contracts/commit-convention/README.md#two-governing-contracts).
+
+## Consumers
+
+Moved to [this section](../../contracts/commit-convention/README.md#consumers).
diff --git a/docs/conventions/config-cascade/README.md b/docs/conventions/config-cascade/README.md
@@ -0,0 +1,72 @@
+# Config Cascade Convention
+
+This contract moved to [`docs/contracts/config-cascade/`](../../contracts/config-cascade/README.md). This page keeps its
+headings so links from installed plugin versions still reach each section.
+
+## Boundary: this contract owns the axis, never the keys
+
+Moved to [this section](../../contracts/config-cascade/README.md#boundary-this-contract-owns-the-axis-never-the-keys).
+
+## The layers
+
+Moved to [this section](../../contracts/config-cascade/README.md#the-layers).
+
+### Location of the team layer: a docs convention file, or .claude/<name>
+
+Moved to [this section](../../contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename).
+
+### Why these four and not others
+
+Moved to [this section](../../contracts/config-cascade/README.md#why-these-four-and-not-others).
+
+## Merge semantics
+
+Moved to [this section](../../contracts/config-cascade/README.md#merge-semantics).
+
+### Sanctioned exception class: policy-floor precedence inversion
+
+Moved to [this section](../../contracts/config-cascade/README.md#sanctioned-exception-class-policy-floor-precedence-inversion).
+
+## Overlay naming and the consumer .gitignore
+
+Moved to [this section](../../contracts/config-cascade/README.md#overlay-naming-and-the-consumer-gitignore).
+
+## Expression doctrine: which surfaces are files, and which are convention docs
+
+Moved to [this section](../../contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs).
+
+## Resolution algorithm
+
+Moved to [this section](../../contracts/config-cascade/README.md#resolution-algorithm).
+
+### Per-layer verification verdicts
+
+Moved to [this section](../../contracts/config-cascade/README.md#per-layer-verification-verdicts).
+
+## Versioning
+
+Moved to [this section](../../contracts/config-cascade/README.md#versioning).
+
+## Deviations
+
+Moved to [this section](../../contracts/config-cascade/README.md#deviations).
+
+## Semantics at a glance
+
+Moved to [this section](../../contracts/config-cascade/README.md#semantics-at-a-glance).
+
+## Implementers
+
+Moved to [this section](../../contracts/config-cascade/README.md#implementers).
+
+### Root rule by surface
+
+Moved to [this section](../../contracts/config-cascade/README.md#root-rule-by-surface).
+
+### Overlay spelling drift
+
+Moved to [this section](../../contracts/config-cascade/README.md#overlay-spelling-drift).
+
+## Surfaces listed for later adoption
+
+Moved to [this section](../../contracts/config-cascade/README.md#surfaces-listed-for-later-adoption).
diff --git a/docs/conventions/config-cascade/consumer-gotchas.md b/docs/conventions/config-cascade/consumer-gotchas.md
@@ -0,0 +1,3 @@
+# Consumer-contributed gotchas (config-cascade tier)
+
+Moved to [`docs/contracts/config-cascade/consumer-gotchas.md`](../../contracts/config-cascade/consumer-gotchas.md).
diff --git a/docs/conventions/consumer-config-layering/README.md b/docs/conventions/consumer-config-layering/README.md
@@ -0,0 +1,4 @@
+# Moved → config-cascade
+
+This contract moved to [`docs/contracts/consumer-config-layering/`](../../contracts/consumer-config-layering/README.md). This page keeps its
+headings so links from installed plugin versions still reach each section.
diff --git a/docs/conventions/detector-findings/README.md b/docs/conventions/detector-findings/README.md
@@ -0,0 +1,88 @@
+# Detector findings: reaching the apply relay from outside review:fanout
+
+This contract moved to [`docs/contracts/detector-findings/`](../../contracts/detector-findings/README.md). This page keeps its
+headings so links from installed plugin versions still reach each section.
+
+## Contents
+
+Moved to [this section](../../contracts/detector-findings/README.md#contents).
+
+## Why the contract is format-only
+
+Moved to [this section](../../contracts/detector-findings/README.md#why-the-contract-is-format-only).
+
+## Where the file goes
+
+Moved to [this section](../../contracts/detector-findings/README.md#where-the-file-goes).
+
+## Boundary
+
+Moved to [this section](../../contracts/detector-findings/README.md#boundary).
+
+## The four producer-owned fields
+
+Moved to [this section](../../contracts/detector-findings/README.md#the-four-producer-owned-fields).
+
+## Rule ids and thresholds
+
+Moved to [this section](../../contracts/detector-findings/README.md#rule-ids-and-thresholds).
+
+## The severity crosswalk
+
+Moved to [this section](../../contracts/detector-findings/README.md#the-severity-crosswalk).
+
+## When the remediation is not at Location
+
+Moved to [this section](../../contracts/detector-findings/README.md#when-the-remediation-is-not-at-location).
+
+## When the remediation is owned by the producer's own skill
+
+Moved to [this section](../../contracts/detector-findings/README.md#when-the-remediation-is-owned-by-the-producers-own-skill).
+
+## Auto-applicability is settled per rule, at contract time
+
+Moved to [this section](../../contracts/detector-findings/README.md#auto-applicability-is-settled-per-rule-at-contract-time).
+
+## The remedy is pinned by an assertion, in every scope it fires in
+
+Moved to [this section](../../contracts/detector-findings/README.md#the-remedy-is-pinned-by-an-assertion-in-every-scope-it-fires-in).
+
+## A candidate that is not a finding
+
+Moved to [this section](../../contracts/detector-findings/README.md#a-candidate-that-is-not-a-finding).
+
+## Coexisting with other producers
+
+Moved to [this section](../../contracts/detector-findings/README.md#coexisting-with-other-producers).
+
+## Emitting more than once
+
+Moved to [this section](../../contracts/detector-findings/README.md#emitting-more-than-once).
+
+## What a minimally conforming producer may omit
+
+Moved to [this section](../../contracts/detector-findings/README.md#what-a-minimally-conforming-producer-may-omit).
+
+## Liveness
+
+Moved to [this section](../../contracts/detector-findings/README.md#liveness).
+
+## Many emitters, one statement of each mechanic
+
+Moved to [this section](../../contracts/detector-findings/README.md#many-emitters-one-statement-of-each-mechanic).
+
+## Enforceability
+
+Moved to [this section](../../contracts/detector-findings/README.md#enforceability).
+
+## Adopters
+
+Moved to [this section](../../contracts/detector-findings/README.md#adopters).
+
+## Versioning
+
+Moved to [this section](../../contracts/detector-findings/README.md#versioning).
+
+## External authority
+
+Moved to [this section](../../contracts/detector-findings/README.md#external-authority).
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# Adopting the git-hook entries

		Moved to [`docs/contracts/check-placement/adopting-git-hooks.md`](../../contracts/check-placement/adopting-git-hooks.md).
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# Consumer-contributed gotchas (config-cascade tier)

		Moved to [`docs/contracts/config-cascade/consumer-gotchas.md`](../../contracts/config-cascade/consumer-gotchas.md).