Repository navigation
docs(contracts): leave stubs at the moved contracts' old paths #10957
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Closed
Closed
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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). |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This stub sends readers to the wrong place and describes itself inaccurately.
docs/contracts/consumer-config-layering/README.mdis itself a rename tombstone: "Moved →config-cascade", renamed in conventions: rename consumer-config-layering seam -> config-cascade #1188. A reader following this stub lands on that tombstone and needs a second hop to reachconfig-cascade. The heading# Moved → config-cascadepromises a direct pointer, but the only link goes to the tombstone.../../contracts/config-cascade/README.md, as the contract's own tombstone does. Drop or replace the "keeps its headings" sentence, and say that the contract was renamed.claude-lane: claude-review