Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 0 additions & 3 deletions .lycheeignore
Original file line number Diff line number Diff line change
Expand Up @@ -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)(/|#|$)
40 changes: 40 additions & 0 deletions docs/conventions/argument-hint/README.md
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).
48 changes: 48 additions & 0 deletions docs/conventions/authoring-formats/README.md
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).
64 changes: 64 additions & 0 deletions docs/conventions/check-placement/README.md
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).
3 changes: 3 additions & 0 deletions docs/conventions/check-placement/adopting-git-hooks.md
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).
24 changes: 24 additions & 0 deletions docs/conventions/commit-convention/README.md
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).
72 changes: 72 additions & 0 deletions docs/conventions/config-cascade/README.md
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).
3 changes: 3 additions & 0 deletions docs/conventions/config-cascade/consumer-gotchas.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).
4 changes: 4 additions & 0 deletions docs/conventions/consumer-config-layering/README.md
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
Comment on lines +1 to +3

Copy link
Copy Markdown
Contributor

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.

  • Two hops. docs/contracts/consumer-config-layering/README.md is 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 reach config-cascade. The heading # Moved → config-cascade promises a direct pointer, but the only link goes to the tombstone.
  • False sentence. Line 4 says "This page keeps its headings so links from installed plugin versions still reach each section". This page has no section headings, so the sentence is untrue here.
  • Fix. Link straight to ../../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

headings so links from installed plugin versions still reach each section.
88 changes: 88 additions & 0 deletions docs/conventions/detector-findings/README.md
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).
Loading
Loading