From c10bdd81170ea71328ac773f298003dce7eb31a9 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sat, 21 Nov 2026 12:04:49 -0500 Subject: [PATCH 1/8] docs(config-cascade): add one editable list of config locations docs/contracts/config-cascade/locations.md lists the four layers, the .local naming and the paths outside the contract, pointing at the README sections. Every plugin the old-path docs grep hit carries a generated copy at reference/config-locations.md through the sync gate. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015XWwmfSVU9f2by5nqbM3Ak --- .../adhd/docs-config-locations-10534342.md | 7 +++ .../docs-config-locations-a8e694e1.md | 7 +++ .../ai-slop/docs-config-locations-9a460e7b.md | 7 +++ .../docs-config-locations-e5199209.md | 7 +++ .../docs-config-locations-5b4128d9.md | 7 +++ .../docs-config-locations-44f7a84e.md | 7 +++ .../docs-config-locations-66a10e61.md | 7 +++ .../bugs/docs-config-locations-739d7f23.md | 7 +++ .../docs-config-locations-92638a9f.md | 7 +++ .../docs-config-locations-8c98795d.md | 7 +++ .../docs-config-locations-79f8d46b.md | 7 +++ .../docs-config-locations-a26656d1.md | 7 +++ .../docs-config-locations-e943110a.md | 7 +++ .../docs-config-locations-98a10919.md | 7 +++ .../docs-config-locations-b434a16e.md | 7 +++ .../docs-config-locations-9f24c799.md | 7 +++ .../docs-config-locations-9995658b.md | 7 +++ .../docs-config-locations-50746568.md | 7 +++ .../docs-config-locations-f11d0f1b.md | 7 +++ .../docs-config-locations-47828876.md | 7 +++ .../docs-config-locations-584b7616.md | 7 +++ .../docs-config-locations-306a4e1d.md | 7 +++ .../docs-config-locations-f658770a.md | 7 +++ .../docs-config-locations-9397920f.md | 7 +++ .../fleet/docs-config-locations-95087e01.md | 7 +++ .../docs-config-locations-c1c046d9.md | 7 +++ .../docs-config-locations-b3320463.md | 7 +++ .../docs-config-locations-e8373e15.md | 7 +++ .../docs-config-locations-2869d22d.md | 7 +++ .../docs-config-locations-65215255.md | 7 +++ .../docs-config-locations-a3849406.md | 7 +++ .../docs-config-locations-b6289359.md | 7 +++ .../docs-config-locations-6e40087b.md | 7 +++ .../docs-config-locations-23f09539.md | 7 +++ .../miro/docs-config-locations-4f670824.md | 7 +++ .../docs-config-locations-5d9b0546.md | 7 +++ .../docs-config-locations-9c5b0b10.md | 7 +++ .../docs-config-locations-2d5f4636.md | 7 +++ .../docs-config-locations-40d672b5.md | 7 +++ .../docs-config-locations-4954f57b.md | 7 +++ .../docs-config-locations-9208470f.md | 7 +++ .../docs-config-locations-6441774a.md | 7 +++ .../docs-config-locations-c5e37034.md | 7 +++ .../docs-config-locations-17f7b5a2.md | 7 +++ .../docs-config-locations-24e64470.md | 7 +++ .../docs-config-locations-51682f29.md | 7 +++ .../review/docs-config-locations-0c394252.md | 7 +++ .../docs-config-locations-31a0c9e7.md | 7 +++ .../docs-config-locations-a0a6a1c5.md | 7 +++ .../docs-config-locations-e40b32a8.md | 7 +++ .../testing/docs-config-locations-18626a62.md | 7 +++ .../docs-config-locations-2f4a2460.md | 7 +++ .../docs-config-locations-5507d073.md | 7 +++ .../docs-config-locations-1789468b.md | 7 +++ docs/contracts/config-cascade/CHANGELOG.md | 4 ++ docs/contracts/config-cascade/README.md | 4 +- docs/contracts/config-cascade/locations.md | 44 +++++++++++++++ plugins/adhd/reference/config-locations.md | 47 ++++++++++++++++ .../ai-briefing/reference/config-locations.md | 47 ++++++++++++++++ plugins/ai-slop/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../attribution/reference/config-locations.md | 47 ++++++++++++++++ .../autonomy/reference/config-locations.md | 47 ++++++++++++++++ .../bash-format/reference/config-locations.md | 47 ++++++++++++++++ plugins/bugs/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../debugging/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../discipline/reference/config-locations.md | 47 ++++++++++++++++ .../discovery/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../docs-naming/reference/config-locations.md | 47 ++++++++++++++++ .../dometrain/reference/config-locations.md | 47 ++++++++++++++++ .../education/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ plugins/fleet/reference/config-locations.md | 47 ++++++++++++++++ .../guardrails/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../harness-ops/reference/config-locations.md | 47 ++++++++++++++++ .../improvement/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ plugins/miro/reference/config-locations.md | 47 ++++++++++++++++ .../multi-agent/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../performance/reference/config-locations.md | 47 ++++++++++++++++ .../planning/reference/config-locations.md | 47 ++++++++++++++++ .../playbooks/reference/config-locations.md | 47 ++++++++++++++++ .../playwright/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../prototype/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ plugins/review/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ plugins/testing/reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../reference/config-locations.md | 47 ++++++++++++++++ .../work-items/reference/config-locations.md | 47 ++++++++++++++++ scripts/shared-copies.txt | 54 +++++++++++++++++++ 112 files changed, 3021 insertions(+), 1 deletion(-) create mode 100644 .changes/adhd/docs-config-locations-10534342.md create mode 100644 .changes/ai-briefing/docs-config-locations-a8e694e1.md create mode 100644 .changes/ai-slop/docs-config-locations-9a460e7b.md create mode 100644 .changes/architecture/docs-config-locations-e5199209.md create mode 100644 .changes/attribution/docs-config-locations-5b4128d9.md create mode 100644 .changes/autonomy/docs-config-locations-44f7a84e.md create mode 100644 .changes/bash-format/docs-config-locations-66a10e61.md create mode 100644 .changes/bugs/docs-config-locations-739d7f23.md create mode 100644 .changes/code-metrics/docs-config-locations-92638a9f.md create mode 100644 .changes/code-tidying/docs-config-locations-8c98795d.md create mode 100644 .changes/codebase-health/docs-config-locations-79f8d46b.md create mode 100644 .changes/context-budget/docs-config-locations-a26656d1.md create mode 100644 .changes/context-usage/docs-config-locations-e943110a.md create mode 100644 .changes/debugging/docs-config-locations-98a10919.md create mode 100644 .changes/desktop-notification/docs-config-locations-b434a16e.md create mode 100644 .changes/developer-experience/docs-config-locations-9f24c799.md create mode 100644 .changes/discipline/docs-config-locations-9995658b.md create mode 100644 .changes/discovery/docs-config-locations-50746568.md create mode 100644 .changes/disk-hygiene/docs-config-locations-f11d0f1b.md create mode 100644 .changes/docs-hygiene/docs-config-locations-47828876.md create mode 100644 .changes/docs-naming/docs-config-locations-584b7616.md create mode 100644 .changes/dometrain/docs-config-locations-306a4e1d.md create mode 100644 .changes/education/docs-config-locations-f658770a.md create mode 100644 .changes/eol-normalizer/docs-config-locations-9397920f.md create mode 100644 .changes/fleet/docs-config-locations-95087e01.md create mode 100644 .changes/guardrails/docs-config-locations-c1c046d9.md create mode 100644 .changes/harness-config/docs-config-locations-b3320463.md create mode 100644 .changes/harness-memory/docs-config-locations-e8373e15.md create mode 100644 .changes/harness-ops/docs-config-locations-2869d22d.md create mode 100644 .changes/improvement/docs-config-locations-65215255.md create mode 100644 .changes/instruction-placement/docs-config-locations-a3849406.md create mode 100644 .changes/javascript-format/docs-config-locations-b6289359.md create mode 100644 .changes/kindle-dedrm/docs-config-locations-6e40087b.md create mode 100644 .changes/machine-health/docs-config-locations-23f09539.md create mode 100644 .changes/miro/docs-config-locations-4f670824.md create mode 100644 .changes/multi-agent/docs-config-locations-5d9b0546.md create mode 100644 .changes/mutation-testing/docs-config-locations-9c5b0b10.md create mode 100644 .changes/overengineering/docs-config-locations-2d5f4636.md create mode 100644 .changes/performance/docs-config-locations-40d672b5.md create mode 100644 .changes/planning/docs-config-locations-4954f57b.md create mode 100644 .changes/playbooks/docs-config-locations-9208470f.md create mode 100644 .changes/playwright/docs-config-locations-6441774a.md create mode 100644 .changes/plugin-profiles/docs-config-locations-c5e37034.md create mode 100644 .changes/plugin-quality/docs-config-locations-17f7b5a2.md create mode 100644 .changes/prototype/docs-config-locations-24e64470.md create mode 100644 .changes/repo-hygiene/docs-config-locations-51682f29.md create mode 100644 .changes/review/docs-config-locations-0c394252.md create mode 100644 .changes/session-flow/docs-config-locations-31a0c9e7.md create mode 100644 .changes/skill-quality/docs-config-locations-a0a6a1c5.md create mode 100644 .changes/source-control/docs-config-locations-e40b32a8.md create mode 100644 .changes/testing/docs-config-locations-18626a62.md create mode 100644 .changes/user-experience/docs-config-locations-2f4a2460.md create mode 100644 .changes/visualization/docs-config-locations-5507d073.md create mode 100644 .changes/work-items/docs-config-locations-1789468b.md create mode 100644 docs/contracts/config-cascade/locations.md create mode 100644 plugins/adhd/reference/config-locations.md create mode 100644 plugins/ai-briefing/reference/config-locations.md create mode 100644 plugins/ai-slop/reference/config-locations.md create mode 100644 plugins/architecture/reference/config-locations.md create mode 100644 plugins/attribution/reference/config-locations.md create mode 100644 plugins/autonomy/reference/config-locations.md create mode 100644 plugins/bash-format/reference/config-locations.md create mode 100644 plugins/bugs/reference/config-locations.md create mode 100644 plugins/code-metrics/reference/config-locations.md create mode 100644 plugins/code-tidying/reference/config-locations.md create mode 100644 plugins/codebase-health/reference/config-locations.md create mode 100644 plugins/context-budget/reference/config-locations.md create mode 100644 plugins/context-usage/reference/config-locations.md create mode 100644 plugins/debugging/reference/config-locations.md create mode 100644 plugins/desktop-notification/reference/config-locations.md create mode 100644 plugins/developer-experience/reference/config-locations.md create mode 100644 plugins/discipline/reference/config-locations.md create mode 100644 plugins/discovery/reference/config-locations.md create mode 100644 plugins/disk-hygiene/reference/config-locations.md create mode 100644 plugins/docs-hygiene/reference/config-locations.md create mode 100644 plugins/docs-naming/reference/config-locations.md create mode 100644 plugins/dometrain/reference/config-locations.md create mode 100644 plugins/education/reference/config-locations.md create mode 100644 plugins/eol-normalizer/reference/config-locations.md create mode 100644 plugins/fleet/reference/config-locations.md create mode 100644 plugins/guardrails/reference/config-locations.md create mode 100644 plugins/harness-config/reference/config-locations.md create mode 100644 plugins/harness-memory/reference/config-locations.md create mode 100644 plugins/harness-ops/reference/config-locations.md create mode 100644 plugins/improvement/reference/config-locations.md create mode 100644 plugins/instruction-placement/reference/config-locations.md create mode 100644 plugins/javascript-format/reference/config-locations.md create mode 100644 plugins/kindle-dedrm/reference/config-locations.md create mode 100644 plugins/machine-health/reference/config-locations.md create mode 100644 plugins/miro/reference/config-locations.md create mode 100644 plugins/multi-agent/reference/config-locations.md create mode 100644 plugins/mutation-testing/reference/config-locations.md create mode 100644 plugins/overengineering/reference/config-locations.md create mode 100644 plugins/performance/reference/config-locations.md create mode 100644 plugins/planning/reference/config-locations.md create mode 100644 plugins/playbooks/reference/config-locations.md create mode 100644 plugins/playwright/reference/config-locations.md create mode 100644 plugins/plugin-profiles/reference/config-locations.md create mode 100644 plugins/plugin-quality/reference/config-locations.md create mode 100644 plugins/prototype/reference/config-locations.md create mode 100644 plugins/repo-hygiene/reference/config-locations.md create mode 100644 plugins/review/reference/config-locations.md create mode 100644 plugins/session-flow/reference/config-locations.md create mode 100644 plugins/skill-quality/reference/config-locations.md create mode 100644 plugins/source-control/reference/config-locations.md create mode 100644 plugins/testing/reference/config-locations.md create mode 100644 plugins/user-experience/reference/config-locations.md create mode 100644 plugins/visualization/reference/config-locations.md create mode 100644 plugins/work-items/reference/config-locations.md diff --git a/.changes/adhd/docs-config-locations-10534342.md b/.changes/adhd/docs-config-locations-10534342.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/adhd/docs-config-locations-10534342.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/ai-briefing/docs-config-locations-a8e694e1.md b/.changes/ai-briefing/docs-config-locations-a8e694e1.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/ai-briefing/docs-config-locations-a8e694e1.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/ai-slop/docs-config-locations-9a460e7b.md b/.changes/ai-slop/docs-config-locations-9a460e7b.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/ai-slop/docs-config-locations-9a460e7b.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/architecture/docs-config-locations-e5199209.md b/.changes/architecture/docs-config-locations-e5199209.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/architecture/docs-config-locations-e5199209.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/attribution/docs-config-locations-5b4128d9.md b/.changes/attribution/docs-config-locations-5b4128d9.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/attribution/docs-config-locations-5b4128d9.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/autonomy/docs-config-locations-44f7a84e.md b/.changes/autonomy/docs-config-locations-44f7a84e.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/autonomy/docs-config-locations-44f7a84e.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/bash-format/docs-config-locations-66a10e61.md b/.changes/bash-format/docs-config-locations-66a10e61.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/bash-format/docs-config-locations-66a10e61.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/bugs/docs-config-locations-739d7f23.md b/.changes/bugs/docs-config-locations-739d7f23.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/bugs/docs-config-locations-739d7f23.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/code-metrics/docs-config-locations-92638a9f.md b/.changes/code-metrics/docs-config-locations-92638a9f.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/code-metrics/docs-config-locations-92638a9f.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/code-tidying/docs-config-locations-8c98795d.md b/.changes/code-tidying/docs-config-locations-8c98795d.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/code-tidying/docs-config-locations-8c98795d.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/codebase-health/docs-config-locations-79f8d46b.md b/.changes/codebase-health/docs-config-locations-79f8d46b.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/codebase-health/docs-config-locations-79f8d46b.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/context-budget/docs-config-locations-a26656d1.md b/.changes/context-budget/docs-config-locations-a26656d1.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/context-budget/docs-config-locations-a26656d1.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/context-usage/docs-config-locations-e943110a.md b/.changes/context-usage/docs-config-locations-e943110a.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/context-usage/docs-config-locations-e943110a.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/debugging/docs-config-locations-98a10919.md b/.changes/debugging/docs-config-locations-98a10919.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/debugging/docs-config-locations-98a10919.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/desktop-notification/docs-config-locations-b434a16e.md b/.changes/desktop-notification/docs-config-locations-b434a16e.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/desktop-notification/docs-config-locations-b434a16e.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/developer-experience/docs-config-locations-9f24c799.md b/.changes/developer-experience/docs-config-locations-9f24c799.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/developer-experience/docs-config-locations-9f24c799.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/discipline/docs-config-locations-9995658b.md b/.changes/discipline/docs-config-locations-9995658b.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/discipline/docs-config-locations-9995658b.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/discovery/docs-config-locations-50746568.md b/.changes/discovery/docs-config-locations-50746568.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/discovery/docs-config-locations-50746568.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/disk-hygiene/docs-config-locations-f11d0f1b.md b/.changes/disk-hygiene/docs-config-locations-f11d0f1b.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/disk-hygiene/docs-config-locations-f11d0f1b.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/docs-hygiene/docs-config-locations-47828876.md b/.changes/docs-hygiene/docs-config-locations-47828876.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/docs-hygiene/docs-config-locations-47828876.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/docs-naming/docs-config-locations-584b7616.md b/.changes/docs-naming/docs-config-locations-584b7616.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/docs-naming/docs-config-locations-584b7616.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/dometrain/docs-config-locations-306a4e1d.md b/.changes/dometrain/docs-config-locations-306a4e1d.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/dometrain/docs-config-locations-306a4e1d.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/education/docs-config-locations-f658770a.md b/.changes/education/docs-config-locations-f658770a.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/education/docs-config-locations-f658770a.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/eol-normalizer/docs-config-locations-9397920f.md b/.changes/eol-normalizer/docs-config-locations-9397920f.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/eol-normalizer/docs-config-locations-9397920f.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/fleet/docs-config-locations-95087e01.md b/.changes/fleet/docs-config-locations-95087e01.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/fleet/docs-config-locations-95087e01.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/guardrails/docs-config-locations-c1c046d9.md b/.changes/guardrails/docs-config-locations-c1c046d9.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/guardrails/docs-config-locations-c1c046d9.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/harness-config/docs-config-locations-b3320463.md b/.changes/harness-config/docs-config-locations-b3320463.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/harness-config/docs-config-locations-b3320463.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/harness-memory/docs-config-locations-e8373e15.md b/.changes/harness-memory/docs-config-locations-e8373e15.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/harness-memory/docs-config-locations-e8373e15.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/harness-ops/docs-config-locations-2869d22d.md b/.changes/harness-ops/docs-config-locations-2869d22d.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/harness-ops/docs-config-locations-2869d22d.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/improvement/docs-config-locations-65215255.md b/.changes/improvement/docs-config-locations-65215255.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/improvement/docs-config-locations-65215255.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/instruction-placement/docs-config-locations-a3849406.md b/.changes/instruction-placement/docs-config-locations-a3849406.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/instruction-placement/docs-config-locations-a3849406.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/javascript-format/docs-config-locations-b6289359.md b/.changes/javascript-format/docs-config-locations-b6289359.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/javascript-format/docs-config-locations-b6289359.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/kindle-dedrm/docs-config-locations-6e40087b.md b/.changes/kindle-dedrm/docs-config-locations-6e40087b.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/kindle-dedrm/docs-config-locations-6e40087b.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/machine-health/docs-config-locations-23f09539.md b/.changes/machine-health/docs-config-locations-23f09539.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/machine-health/docs-config-locations-23f09539.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/miro/docs-config-locations-4f670824.md b/.changes/miro/docs-config-locations-4f670824.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/miro/docs-config-locations-4f670824.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/multi-agent/docs-config-locations-5d9b0546.md b/.changes/multi-agent/docs-config-locations-5d9b0546.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/multi-agent/docs-config-locations-5d9b0546.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/mutation-testing/docs-config-locations-9c5b0b10.md b/.changes/mutation-testing/docs-config-locations-9c5b0b10.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/mutation-testing/docs-config-locations-9c5b0b10.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/overengineering/docs-config-locations-2d5f4636.md b/.changes/overengineering/docs-config-locations-2d5f4636.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/overengineering/docs-config-locations-2d5f4636.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/performance/docs-config-locations-40d672b5.md b/.changes/performance/docs-config-locations-40d672b5.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/performance/docs-config-locations-40d672b5.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/planning/docs-config-locations-4954f57b.md b/.changes/planning/docs-config-locations-4954f57b.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/planning/docs-config-locations-4954f57b.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/playbooks/docs-config-locations-9208470f.md b/.changes/playbooks/docs-config-locations-9208470f.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/playbooks/docs-config-locations-9208470f.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/playwright/docs-config-locations-6441774a.md b/.changes/playwright/docs-config-locations-6441774a.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/playwright/docs-config-locations-6441774a.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/plugin-profiles/docs-config-locations-c5e37034.md b/.changes/plugin-profiles/docs-config-locations-c5e37034.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/plugin-profiles/docs-config-locations-c5e37034.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/plugin-quality/docs-config-locations-17f7b5a2.md b/.changes/plugin-quality/docs-config-locations-17f7b5a2.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/plugin-quality/docs-config-locations-17f7b5a2.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/prototype/docs-config-locations-24e64470.md b/.changes/prototype/docs-config-locations-24e64470.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/prototype/docs-config-locations-24e64470.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/repo-hygiene/docs-config-locations-51682f29.md b/.changes/repo-hygiene/docs-config-locations-51682f29.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/repo-hygiene/docs-config-locations-51682f29.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/review/docs-config-locations-0c394252.md b/.changes/review/docs-config-locations-0c394252.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/review/docs-config-locations-0c394252.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/session-flow/docs-config-locations-31a0c9e7.md b/.changes/session-flow/docs-config-locations-31a0c9e7.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/session-flow/docs-config-locations-31a0c9e7.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/skill-quality/docs-config-locations-a0a6a1c5.md b/.changes/skill-quality/docs-config-locations-a0a6a1c5.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/skill-quality/docs-config-locations-a0a6a1c5.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/source-control/docs-config-locations-e40b32a8.md b/.changes/source-control/docs-config-locations-e40b32a8.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/source-control/docs-config-locations-e40b32a8.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/testing/docs-config-locations-18626a62.md b/.changes/testing/docs-config-locations-18626a62.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/testing/docs-config-locations-18626a62.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/user-experience/docs-config-locations-2f4a2460.md b/.changes/user-experience/docs-config-locations-2f4a2460.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/user-experience/docs-config-locations-2f4a2460.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/visualization/docs-config-locations-5507d073.md b/.changes/visualization/docs-config-locations-5507d073.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/visualization/docs-config-locations-5507d073.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/work-items/docs-config-locations-1789468b.md b/.changes/work-items/docs-config-locations-1789468b.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/work-items/docs-config-locations-1789468b.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/docs/contracts/config-cascade/CHANGELOG.md b/docs/contracts/config-cascade/CHANGELOG.md index eb342ae99f3..dc604c20cf0 100644 --- a/docs/contracts/config-cascade/CHANGELOG.md +++ b/docs/contracts/config-cascade/CHANGELOG.md @@ -11,6 +11,10 @@ adding an optional layer or relaxing a rule additively is a minor bump. No contract change. +- **`locations.md` lists where plugin config lives.** One editable page of the four layers, the + `.local` naming and the paths outside the contract, pointing at this README's sections. Plugins + that teach a config location carry a generated copy at `reference/config-locations.md`. The + layering axis is unchanged, so `contract_version` stays. - **`plugin-quality` gets a `standards_repo` row.** A team-only key in `/plugin-quality.yaml` beside `verification`, read by the auditor agent; unset resolves no standards repository. - **`improvement` and the `architecture` `improve` object get Implementers rows.** `improvement` diff --git a/docs/contracts/config-cascade/README.md b/docs/contracts/config-cascade/README.md index dc7c5fdd422..85e2efd3e8d 100644 --- a/docs/contracts/config-cascade/README.md +++ b/docs/contracts/config-cascade/README.md @@ -10,7 +10,9 @@ surface has learned all of them. This directory is the source of truth: `README.md` (the contract), `CHANGELOG.md` (version history), and topic siblings such as [`consumer-gotchas.md`](consumer-gotchas.md) (concatenating consumer gotchas -for participating skills, #3547). +for participating skills, #3547). [`locations.md`](locations.md) is the one editable list of config +file locations; each plugin that teaches one carries a generated copy at +`reference/config-locations.md`. ## Boundary: this contract owns the axis, never the keys diff --git a/docs/contracts/config-cascade/locations.md b/docs/contracts/config-cascade/locations.md new file mode 100644 index 00000000000..820585dbab7 --- /dev/null +++ b/docs/contracts/config-cascade/locations.md @@ -0,0 +1,44 @@ +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/adhd/reference/config-locations.md b/plugins/adhd/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/adhd/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/ai-briefing/reference/config-locations.md b/plugins/ai-briefing/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/ai-briefing/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/ai-slop/reference/config-locations.md b/plugins/ai-slop/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/ai-slop/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/architecture/reference/config-locations.md b/plugins/architecture/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/architecture/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/attribution/reference/config-locations.md b/plugins/attribution/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/attribution/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/autonomy/reference/config-locations.md b/plugins/autonomy/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/autonomy/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/bash-format/reference/config-locations.md b/plugins/bash-format/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/bash-format/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/bugs/reference/config-locations.md b/plugins/bugs/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/bugs/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/code-metrics/reference/config-locations.md b/plugins/code-metrics/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/code-metrics/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/code-tidying/reference/config-locations.md b/plugins/code-tidying/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/code-tidying/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/codebase-health/reference/config-locations.md b/plugins/codebase-health/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/codebase-health/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/context-budget/reference/config-locations.md b/plugins/context-budget/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/context-budget/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/context-usage/reference/config-locations.md b/plugins/context-usage/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/context-usage/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/debugging/reference/config-locations.md b/plugins/debugging/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/debugging/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/desktop-notification/reference/config-locations.md b/plugins/desktop-notification/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/desktop-notification/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/developer-experience/reference/config-locations.md b/plugins/developer-experience/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/developer-experience/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/discipline/reference/config-locations.md b/plugins/discipline/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/discipline/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/discovery/reference/config-locations.md b/plugins/discovery/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/discovery/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/disk-hygiene/reference/config-locations.md b/plugins/disk-hygiene/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/disk-hygiene/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/docs-hygiene/reference/config-locations.md b/plugins/docs-hygiene/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/docs-hygiene/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/docs-naming/reference/config-locations.md b/plugins/docs-naming/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/docs-naming/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/dometrain/reference/config-locations.md b/plugins/dometrain/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/dometrain/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/education/reference/config-locations.md b/plugins/education/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/education/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/eol-normalizer/reference/config-locations.md b/plugins/eol-normalizer/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/eol-normalizer/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/fleet/reference/config-locations.md b/plugins/fleet/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/fleet/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/guardrails/reference/config-locations.md b/plugins/guardrails/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/guardrails/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/harness-config/reference/config-locations.md b/plugins/harness-config/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/harness-config/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/harness-memory/reference/config-locations.md b/plugins/harness-memory/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/harness-memory/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/harness-ops/reference/config-locations.md b/plugins/harness-ops/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/harness-ops/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/improvement/reference/config-locations.md b/plugins/improvement/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/improvement/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/instruction-placement/reference/config-locations.md b/plugins/instruction-placement/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/instruction-placement/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/javascript-format/reference/config-locations.md b/plugins/javascript-format/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/javascript-format/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/kindle-dedrm/reference/config-locations.md b/plugins/kindle-dedrm/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/kindle-dedrm/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/machine-health/reference/config-locations.md b/plugins/machine-health/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/machine-health/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/miro/reference/config-locations.md b/plugins/miro/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/miro/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/multi-agent/reference/config-locations.md b/plugins/multi-agent/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/multi-agent/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/mutation-testing/reference/config-locations.md b/plugins/mutation-testing/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/mutation-testing/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/overengineering/reference/config-locations.md b/plugins/overengineering/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/overengineering/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/performance/reference/config-locations.md b/plugins/performance/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/performance/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/planning/reference/config-locations.md b/plugins/planning/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/planning/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/playbooks/reference/config-locations.md b/plugins/playbooks/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/playbooks/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/playwright/reference/config-locations.md b/plugins/playwright/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/playwright/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/plugin-profiles/reference/config-locations.md b/plugins/plugin-profiles/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/plugin-profiles/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/plugin-quality/reference/config-locations.md b/plugins/plugin-quality/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/plugin-quality/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/prototype/reference/config-locations.md b/plugins/prototype/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/prototype/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/repo-hygiene/reference/config-locations.md b/plugins/repo-hygiene/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/repo-hygiene/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/review/reference/config-locations.md b/plugins/review/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/review/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/session-flow/reference/config-locations.md b/plugins/session-flow/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/session-flow/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/skill-quality/reference/config-locations.md b/plugins/skill-quality/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/skill-quality/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/source-control/reference/config-locations.md b/plugins/source-control/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/source-control/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/testing/reference/config-locations.md b/plugins/testing/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/testing/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/user-experience/reference/config-locations.md b/plugins/user-experience/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/user-experience/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/visualization/reference/config-locations.md b/plugins/visualization/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/visualization/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/work-items/reference/config-locations.md b/plugins/work-items/reference/config-locations.md new file mode 100644 index 00000000000..dbba05c5cfb --- /dev/null +++ b/plugins/work-items/reference/config-locations.md @@ -0,0 +1,47 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, +never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No `.claude/` file for plugin config.** Team and personal files live at ``, never + `.claude/` or `.claude/.local.`. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in +its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs +name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/scripts/shared-copies.txt b/scripts/shared-copies.txt index 9da69feacda..ec1388970c7 100644 --- a/scripts/shared-copies.txt +++ b/scripts/shared-copies.txt @@ -1007,3 +1007,57 @@ lib/lane-instance-collision-check.md plugins/work-items/skills/work-loop/referen lib/cli-version-check.mjs plugins/context7/lib/cli-version-check.mjs lib/cli-version-check.mjs plugins/firecrawl/lib/cli-version-check.mjs lib/cli-version-check.mjs plugins/playwright/lib/cli-version-check.mjs +docs/contracts/config-cascade/locations.md plugins/adhd/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/ai-briefing/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/ai-slop/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/architecture/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/attribution/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/autonomy/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/bash-format/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/bugs/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/code-metrics/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/code-tidying/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/codebase-health/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/context-budget/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/context-usage/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/debugging/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/desktop-notification/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/developer-experience/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/discipline/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/discovery/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/disk-hygiene/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/docs-hygiene/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/docs-naming/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/dometrain/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/education/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/eol-normalizer/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/fleet/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/guardrails/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/harness-config/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/harness-memory/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/harness-ops/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/improvement/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/instruction-placement/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/javascript-format/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/kindle-dedrm/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/machine-health/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/miro/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/multi-agent/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/mutation-testing/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/overengineering/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/performance/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/planning/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/playbooks/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/playwright/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/plugin-profiles/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/plugin-quality/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/prototype/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/repo-hygiene/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/review/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/session-flow/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/skill-quality/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/source-control/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/testing/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/user-experience/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/visualization/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/work-items/reference/config-locations.md From fb51c597cded0ba009af51248f2f06eeae6c65d1 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sat, 21 Nov 2026 12:12:47 -0500 Subject: [PATCH 2/8] docs(config-cascade): point old-path config docs at config locations Each doc that names a ~/.claude/ or .claude/.local.* path for plugin config keeps the fact (its resolver still reads or retires that path) and gains one pointer to the plugin's reference/config-locations.md, or to the canonical page from docs/. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015XWwmfSVU9f2by5nqbM3Ak --- docs/contracts/commit-convention/README.md | 2 ++ docs/contracts/finding-suppression/README.md | 2 ++ docs/contracts/rendered-views/README.md | 2 ++ docs/conventions/review-digest.md | 2 ++ plugins/attribution/README.md | 4 +++- plugins/attribution/skills/audit/SKILL.md | 2 ++ plugins/attribution/skills/setup/SKILL.md | 2 ++ plugins/bugs/reference/config.md | 2 ++ plugins/bugs/skills/setup/SKILL.md | 2 ++ plugins/code-metrics/README.md | 2 ++ plugins/code-metrics/reference/config.md | 2 ++ .../code-metrics/skills/principles/reference/thresholds.md | 2 ++ plugins/code-metrics/skills/setup/SKILL.md | 2 ++ plugins/codebase-health/README.md | 2 ++ plugins/codebase-health/skills/audit/SKILL.md | 2 ++ plugins/codebase-health/skills/setup/SKILL.md | 2 ++ plugins/discovery/README.md | 2 ++ plugins/disk-hygiene/README.md | 2 ++ plugins/disk-hygiene/skills/clean/SKILL.md | 2 ++ plugins/docs-naming/README.md | 2 ++ plugins/docs-naming/reference/config.md | 2 ++ plugins/docs-naming/skills/setup/SKILL.md | 2 ++ plugins/harness-config/skills/setup/SKILL.md | 2 ++ plugins/improvement/README.md | 2 ++ plugins/improvement/reference/config.md | 2 ++ plugins/improvement/skills/find/context/hotspots.md | 2 ++ plugins/improvement/skills/setup/SKILL.md | 2 ++ plugins/instruction-placement/reference/consumer-config.md | 2 ++ plugins/mutation-testing/skills/audit/context/suppression.md | 2 ++ plugins/mutation-testing/skills/setup/SKILL.md | 2 ++ plugins/overengineering/reference/consumer-config.md | 2 ++ plugins/plugin-quality/reference/config.md | 2 ++ plugins/plugin-quality/skills/setup/SKILL.md | 2 ++ plugins/source-control/README.md | 2 ++ plugins/source-control/reference/config-resolution.md | 2 ++ plugins/source-control/skills/commit/SKILL.md | 2 ++ .../source-control/skills/commit/reference/config-probes.md | 2 ++ plugins/source-control/skills/setup/SKILL.md | 2 ++ .../source-control/skills/setup/reference/apply-convention.md | 2 ++ plugins/testing/README.md | 2 ++ plugins/testing/skills/check-visual-parity/SKILL.md | 2 ++ plugins/testing/skills/run-e2e/SKILL.md | 2 ++ plugins/testing/skills/run-e2e/context/e2e-config.md | 2 ++ plugins/testing/skills/setup/SKILL.md | 2 ++ plugins/testing/skills/write/SKILL.md | 2 ++ 45 files changed, 91 insertions(+), 1 deletion(-) diff --git a/docs/contracts/commit-convention/README.md b/docs/contracts/commit-convention/README.md index 4c1b7bb390f..425351312a3 100644 --- a/docs/contracts/commit-convention/README.md +++ b/docs/contracts/commit-convention/README.md @@ -59,6 +59,8 @@ name the file to change. it: an operator who wants `/source-control:commit` to draft to the same pattern also sets `## subject_pattern` in the drafting personal override, `.claude/source-control.local.md`. + Where plugin config belongs: [config locations](../config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. + The folder-form file, and its fail-closed checks, are read only for a key the YAML lacks: a broken folder-form file never disables a key the YAML supplies. Each key holds exactly one value, never a list. diff --git a/docs/contracts/finding-suppression/README.md b/docs/contracts/finding-suppression/README.md index dddb5de2011..e675d2238c4 100644 --- a/docs/contracts/finding-suppression/README.md +++ b/docs/contracts/finding-suppression/README.md @@ -33,6 +33,8 @@ The consuming plugin names its own surface. The first adopter, `harness-config`' | 2 | team (tracked) | `/harness-config.yaml` (`` from the convention-home pointer line, default `docs/conventions`) | | 3 | personal override (gitignored) | `.claude/audit-pass.local.md` | +Where plugin config belongs: [config locations](../config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. + In a YAML concern file the `suppressions` mapping sits at the root with the entry shape below; a reader that uses the shared YAML-subset parser needs the `"anchor/v1":` key quoted. diff --git a/docs/contracts/rendered-views/README.md b/docs/contracts/rendered-views/README.md index ac4ed623507..e2a40d71a39 100644 --- a/docs/contracts/rendered-views/README.md +++ b/docs/contracts/rendered-views/README.md @@ -928,6 +928,8 @@ lane. A skill runs its `resolve` command and never reads the files itself. chain). Each lane registers once in the medium registry with its view kinds, whether it is hosted-capable, and its default. + Where plugin config belongs: [config locations](../config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. + ## Template vendoring posture **Decision.** Do not vendor the 31 html-effectiveness corpus templates (20 gallery + diff --git a/docs/conventions/review-digest.md b/docs/conventions/review-digest.md index 5b3f90dfe45..ac381c31eb4 100644 --- a/docs/conventions/review-digest.md +++ b/docs/conventions/review-digest.md @@ -55,6 +55,8 @@ an earlier one key by key: the layer below. 3. personal override `.claude/review-digest.local.json` + Where plugin config belongs: [config locations](../contracts/config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. + The result names the layer that supplied each value (`team :`, `user-global `, `personal-override `, or `default`). Quote glob values in the YAML file (`"**/hooks/**"`), since a plain `*` opens an alias. diff --git a/plugins/attribution/README.md b/plugins/attribution/README.md index 294ff901723..2c924288cdf 100644 --- a/plugins/attribution/README.md +++ b/plugins/attribution/README.md @@ -94,7 +94,9 @@ call and routes to its finding-suppression convention, not to a marker this plug The audit detectors read `/attribution.yaml` and `/attribution.local.yaml`, `` being the bound convention home, else `docs/conventions`, over the user-global -`~/.claude/attribution.json`. The old JSON files of the same names under `.claude/` are not read; +`~/.claude/attribution.json` ([config locations](reference/config-locations.md) lists where plugin +config belongs; this user-global read is a declared deviation until it migrates). The old JSON files +of the same names under `.claude/` are not read; `/attribution:setup` reports them and carries their keys into the YAML, which it writes. In YAML, quote a glob that starts with `*` (`- "**/vendor/**"`); a file that does not parse is named on stderr and not read. The keys, layered over the shipped defaults, with their schema in diff --git a/plugins/attribution/skills/audit/SKILL.md b/plugins/attribution/skills/audit/SKILL.md index 9cf400c9691..3d46cd1aff2 100644 --- a/plugins/attribution/skills/audit/SKILL.md +++ b/plugins/attribution/skills/audit/SKILL.md @@ -313,6 +313,8 @@ layer supplying every effective value. The accuracy dials (`nomination_passes`, tunable per repo; the gates bind fix eligibility and release readiness only, and never filter what the report shows. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + When `deep_research_on_exhaustion` is on and a research-capable skill is enabled, a budget-exhausted candidate may escalate to `/discovery:research` (if that plugin is enabled). When it is not enabled, the run says so once and takes the ordinary neutral disposition diff --git a/plugins/attribution/skills/setup/SKILL.md b/plugins/attribution/skills/setup/SKILL.md index ac2f882555b..c8124a26008 100644 --- a/plugins/attribution/skills/setup/SKILL.md +++ b/plugins/attribution/skills/setup/SKILL.md @@ -94,6 +94,8 @@ an earlier one: | 2 | team | `//attribution.yaml` | the repository, tracked | | 3 | personal override | `//attribution.local.yaml` | one operator in one repo, gitignored | +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + `apply` writes only the team layer and the personal override, never the user-global file. Before it writes the personal override, `git check-ignore -q "//attribution.local.yaml"` must exit 0; when it does not, say the file would be tracked and get the operator's choice before writing. diff --git a/plugins/bugs/reference/config.md b/plugins/bugs/reference/config.md index 96b401fec85..644cd884911 100644 --- a/plugins/bugs/reference/config.md +++ b/plugins/bugs/reference/config.md @@ -18,6 +18,8 @@ Three layers, resolved in this order, where a later layer refines an earlier one | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/docs/conventions/bugs.yaml` for the keys; `${CLAUDE_PROJECT_DIR}/docs/conventions/bugs.md` for prose and `## Gotchas` | must be tracked, the only layer teammates receive | | 3 | personal override | `${CLAUDE_PROJECT_DIR}/.claude/bugs.local.md` | must be gitignored, never staged | +Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + The team files sit in `docs/conventions/` whatever convention home the repository binds; a repository that binds another home still keeps them there. diff --git a/plugins/bugs/skills/setup/SKILL.md b/plugins/bugs/skills/setup/SKILL.md index d2493c838ae..b5e132b5a83 100644 --- a/plugins/bugs/skills/setup/SKILL.md +++ b/plugins/bugs/skills/setup/SKILL.md @@ -124,6 +124,8 @@ never written. already covered. 7. **Remind them to stage it.** The team file reaches teammates only once committed. + Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + Re-running `apply` when everything already matches changes nothing and reports "already configured". ## Output diff --git a/plugins/code-metrics/README.md b/plugins/code-metrics/README.md index 1f97e8b2c22..45cab675234 100644 --- a/plugins/code-metrics/README.md +++ b/plugins/code-metrics/README.md @@ -88,6 +88,8 @@ and `enabled`. References ship with their provenance: cyclomatic 20 cites ISO/IE a documented YAML subset (block style, flow sequences of scalars, no flow mappings). Every key: `reference/config.md`; `/code-metrics:setup` writes the team layer and probes the collectors. +Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## The report Every audit prints one `code-metrics/v2` JSON document (`--json`) or its markdown rendering. The diff --git a/plugins/code-metrics/reference/config.md b/plugins/code-metrics/reference/config.md index b41464b1e64..3f29122400c 100644 --- a/plugins/code-metrics/reference/config.md +++ b/plugins/code-metrics/reference/config.md @@ -17,6 +17,8 @@ resolved in this order over the bundled defaults (`scripts/config-defaults.json` | 2 | team | `/docs/conventions/code-metrics.yaml` | the repository, tracked | | 3 | personal override | `/.claude/code-metrics.local.yaml` | one operator in one repository, gitignored | +Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + The team layer is `docs/conventions/code-metrics.yaml` alone. The team file earlier releases read from the repository's `.claude/` directory is retired and never read. `/code-metrics:setup check` reports it, and `/code-metrics:setup apply`, run while the docs file is absent, carries every diff --git a/plugins/code-metrics/skills/principles/reference/thresholds.md b/plugins/code-metrics/skills/principles/reference/thresholds.md index 89bcda045d2..a4da0497348 100644 --- a/plugins/code-metrics/skills/principles/reference/thresholds.md +++ b/plugins/code-metrics/skills/principles/reference/thresholds.md @@ -94,6 +94,8 @@ rest of the defaults intact. The full key list is [`reference/config.md`](../../ that supplied any value a personal layer changed, so a number that differs from a teammate's is traceable to the layer that changed it rather than to the code. +Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + Setting a reference to `null` is a legitimate choice and turns the count off while the measure keeps reporting. Setting one to a value you can defend for your codebase is a better choice than adopting one of these because a standard prints it. diff --git a/plugins/code-metrics/skills/setup/SKILL.md b/plugins/code-metrics/skills/setup/SKILL.md index 9f21d0bc1e8..82b07fa5769 100644 --- a/plugins/code-metrics/skills/setup/SKILL.md +++ b/plugins/code-metrics/skills/setup/SKILL.md @@ -20,6 +20,8 @@ surface and for the external collectors the audits probe: `check` inspects and v persists, and neither installs anything. Keys, defaults, and provenance: `${CLAUDE_PLUGIN_ROOT}/reference/config.md`. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + Action routing: no argument or `check` runs the check; `apply` runs the check first, then persists. `apply` is non-interactive when complete `=` arguments are supplied (automation and headless use pass them and are never prompted); with none, it interviews one key diff --git a/plugins/codebase-health/README.md b/plugins/codebase-health/README.md index d256fa6665f..8c2ad71c986 100644 --- a/plugins/codebase-health/README.md +++ b/plugins/codebase-health/README.md @@ -58,6 +58,8 @@ it>)`, and any notice. A `terminal` result drops the offer. The tracked team fil new home; a `terminal` or `file` value in one still keeps the view local when no other setting decides, and a publishing value there is ignored. +Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## Configurable audit dimensions What the audit reads and how it verifies claims is **not baked in**. It comes from the consuming diff --git a/plugins/codebase-health/skills/audit/SKILL.md b/plugins/codebase-health/skills/audit/SKILL.md index f774cb5e7a0..2f85bab63cc 100644 --- a/plugins/codebase-health/skills/audit/SKILL.md +++ b/plugins/codebase-health/skills/audit/SKILL.md @@ -113,6 +113,8 @@ pass). Come from the consuming repo's tracked config, resolved additively across 2. `.claude/codebase-health.md` (team, tracked) 3. `.claude/codebase-health.local.md` (personal override, gitignored) + Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + The four bundled dimensions are `documentation`, `configuration`, `code-quality`, and `architecture`; the config may tune their globs, remove a dimension, or add custom ones. diff --git a/plugins/codebase-health/skills/setup/SKILL.md b/plugins/codebase-health/skills/setup/SKILL.md index dfb76f27985..9286bfe9d13 100644 --- a/plugins/codebase-health/skills/setup/SKILL.md +++ b/plugins/codebase-health/skills/setup/SKILL.md @@ -25,6 +25,8 @@ earlier layer's and example-claims concatenate, **except** that a later layer de with empty source lists is an explicit opt-out that *removes* that inherited dimension. This skill writes only the **team** file; changes to the user-global layer or the personal override are the user's to make. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## `check` (read-only) Inspect the effective merged config and report a PASS/FAIL/INFO table with one remediation line per diff --git a/plugins/discovery/README.md b/plugins/discovery/README.md index 1ebc3caea75..1b8f49522b4 100644 --- a/plugins/discovery/README.md +++ b/plugins/discovery/README.md @@ -160,6 +160,8 @@ because a spawn's `model` takes an alias only ([sub-agents: choose a model](https://code.claude.com/docs/en/sub-agents#choose-a-model)). With no such layer, or without `multi-agent`, the pins apply. The rule: `reference/parent-contract.md`, "The worker's model is the parent's call". +Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ### Options reference diff --git a/plugins/disk-hygiene/README.md b/plugins/disk-hygiene/README.md index 734563524c6..74d9adfe7f8 100644 --- a/plugins/disk-hygiene/README.md +++ b/plugins/disk-hygiene/README.md @@ -387,6 +387,8 @@ Without `--policy`, standing policy files layer over the baseline when present: `.claude/disk-hygiene.json`. An explicit `--policy` file is the invocation-specific choice and replaces both standing layers. The scan output records which sources applied. +Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + Candidate hints can be disabled or extended. Consumer protection globs are additive. A relative glob matches a path relative to the scan target. A glob that starts with `/`, a drive letter, or `\\` (a UNC path such as `\\server\share\keep\**`) matches the absolute path, so a standing overlay can protect a tree no matter which parent is scanned. An object `{glob, reason}` is accepted. For every entry that matches a path, the scan entry, the preview candidate, the handoff-verify verdict, and a skipped apply path list it under `protection_matches`, sorted and deduplicated, as `{glob}` or `{glob, reason}`. That field sits beside the `consumer-protected-path` reason and is absent when no entry matched. Hard safety predicates and the baseline protected-name/root rules are non-overridable by any layer: a policy file can only add protections, add hints, or disable discovery hints (which can only cause junk to diff --git a/plugins/disk-hygiene/skills/clean/SKILL.md b/plugins/disk-hygiene/skills/clean/SKILL.md index 80f5bd5c9ea..fda5bcb3ead 100644 --- a/plugins/disk-hygiene/skills/clean/SKILL.md +++ b/plugins/disk-hygiene/skills/clean/SKILL.md @@ -233,6 +233,8 @@ and `elevation`; none can weaken hard guards. The [overlay schema](reference/pol lists every field; version 1 files load unchanged. The scan output names its `policy_sources` and the effective `elevation`. Scan errors and unvisited protected roots are coverage gaps, not clean. A hint's `entry_types` and the snapshot's `empty_directory_paths` are in [scan-flags.md](reference/scan-flags.md#coverage-and-hint-fields). +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + The scan output may also carry an `os_autoclean` advisory when the target overlaps a zone an OS mechanism (Windows Storage Sense, systemd-tmpfiles) should own. Surface its recommendation in the report; prefer enabling the OS mechanism over hand-cleaning that zone, mirroring the managed-state diff --git a/plugins/docs-naming/README.md b/plugins/docs-naming/README.md index 900d3ad686e..98b3c406573 100644 --- a/plugins/docs-naming/README.md +++ b/plugins/docs-naming/README.md @@ -51,6 +51,8 @@ into it. A user-global file still at the retired `docs-hygiene` name (`~/.claude/docs-hygiene.json`) is read, with a warning from the resolver; rename it to retire the warning. +Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## Renames are gated per file `realign-file-names` accepts one file at a time. The findings artifact does not diff --git a/plugins/docs-naming/reference/config.md b/plugins/docs-naming/reference/config.md index 968cc1a88f9..edcd3aaf83d 100644 --- a/plugins/docs-naming/reference/config.md +++ b/plugins/docs-naming/reference/config.md @@ -53,6 +53,8 @@ A user-global file absent under `docs-naming.json` but present under the retired stderr warning from `resolve` and a WARN row from `/docs-naming:setup check`. The new name wins when both exist. Rename the file to retire the warning. +Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + All three absent is a valid state: every key has a bundled default, and the defaults are this marketplace's own values, except `generated`, which is empty. The recommended gitignore line for the personal override is `/*.local.*`; `/docs-naming:setup check` reports a diff --git a/plugins/docs-naming/skills/setup/SKILL.md b/plugins/docs-naming/skills/setup/SKILL.md index 8f103d2ac6e..1b5ba176e5f 100644 --- a/plugins/docs-naming/skills/setup/SKILL.md +++ b/plugins/docs-naming/skills/setup/SKILL.md @@ -85,6 +85,8 @@ no cleanup, since neither file is read; the old-file rows name the next step. Th layer row reports it as WARN with the same remedy: rename it to `docs-naming.json` in the same directory. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## `apply` (idempotent) 1. Run `check` and read its table. diff --git a/plugins/harness-config/skills/setup/SKILL.md b/plugins/harness-config/skills/setup/SKILL.md index 96494ce0239..a8841531f76 100644 --- a/plugins/harness-config/skills/setup/SKILL.md +++ b/plugins/harness-config/skills/setup/SKILL.md @@ -127,6 +127,8 @@ tracked/ignored question has opposite correct answers per layer, so verify each - **personal override** `.claude/audit-pass.local.md`: must be gitignored and never staged. Staged or tracked is a FAIL: a personal deviation can reach team history. + Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + Parse each present layer and report as malformed any entry missing **any** of its five required keys: `check`, `claim`, `sites`, `reason`, `date`. Checking only `reason` and `date` would pass an entry that `audit-pass` itself rejects, so readiness would report green on configuration that cannot diff --git a/plugins/improvement/README.md b/plugins/improvement/README.md index 2736d33e7d1..9bf4978ca98 100644 --- a/plugins/improvement/README.md +++ b/plugins/improvement/README.md @@ -45,6 +45,8 @@ churn analysis or declare Tier 2 MCP telemetry sources, run `/improvement:setup` the team `.claude/improvement.md`, then the gitignored `.claude/improvement.local.md` personal override. The key contract lives in [reference/config.md](reference/config.md). +Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## Running it as a standing routine `/improvement:find`'s unattended mode implements the tech-debt-sweep routine shape: a scheduled diff --git a/plugins/improvement/reference/config.md b/plugins/improvement/reference/config.md index 6b99d8c7442..6a717573019 100644 --- a/plugins/improvement/reference/config.md +++ b/plugins/improvement/reference/config.md @@ -17,6 +17,8 @@ Three layers, resolved in this order, where a later layer refines an earlier one | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/improvement.md` | must be tracked, the only layer teammates receive | | 3 | personal override | `${CLAUDE_PROJECT_DIR}/.claude/improvement.local.md` | must be gitignored, never staged | +Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + Resolution anchors at the repo root, `${CLAUDE_PROJECT_DIR}` when set and otherwise `git rev-parse --show-toplevel`, never at the CWD. Every layer that exists is read and merged; reading one layer and stopping is not resolution. A malformed layer degrades soft: surface the diff --git a/plugins/improvement/skills/find/context/hotspots.md b/plugins/improvement/skills/find/context/hotspots.md index 6dca32fc186..44ee671a5f5 100644 --- a/plugins/improvement/skills/find/context/hotspots.md +++ b/plugins/improvement/skills/find/context/hotspots.md @@ -83,6 +83,8 @@ Step 1's `excludes` as one ERE, alternatives joined with `|`, from two sources: The scan asks nothing and writes no record; `/improvement:setup apply` offers to persist them as `churn_exclude` entries. + Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + All layers absent is a valid state. When item 2 resolves nothing while `churn_exclude_defaults` is on, record an evidence-gap line (format: unattended.md), e.g. `gap: churn exclusions — no mechanical files resolved from the repository — declare churn_exclude or run /improvement:setup apply`. diff --git a/plugins/improvement/skills/setup/SKILL.md b/plugins/improvement/skills/setup/SKILL.md index 2eb7935263d..31b7a6b98ac 100644 --- a/plugins/improvement/skills/setup/SKILL.md +++ b/plugins/improvement/skills/setup/SKILL.md @@ -34,6 +34,8 @@ skill writes only the **team** file; changes to the user-global layer or the per user's to make. Anchor every repo-relative read at the repo root (`${CLAUDE_PROJECT_DIR}` when set, otherwise `git rev-parse --show-toplevel`), never at the CWD. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## `check` (read-only) Inspect the effective merged config and report a PASS/FAIL/WARN/INFO table with one remediation line diff --git a/plugins/instruction-placement/reference/consumer-config.md b/plugins/instruction-placement/reference/consumer-config.md index abc646516ff..e3f08d542d6 100644 --- a/plugins/instruction-placement/reference/consumer-config.md +++ b/plugins/instruction-placement/reference/consumer-config.md @@ -35,6 +35,8 @@ Three layers, resolved in this order: | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/instruction-placement.md` | | 3 | personal override (gitignored) | `${CLAUDE_PROJECT_DIR}/.claude/instruction-placement.local.md` | +Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + **Merge form: per-key override**, declared here as the cascade convention requires. Entries merge per `finding_id`: a later layer's entry for one id wins for that id only, and every id it does not mention keeps the earlier layer's entry. Wholesale replacement is forbidden, because a layer diff --git a/plugins/mutation-testing/skills/audit/context/suppression.md b/plugins/mutation-testing/skills/audit/context/suppression.md index f555bb5c0a4..b239b3004f4 100644 --- a/plugins/mutation-testing/skills/audit/context/suppression.md +++ b/plugins/mutation-testing/skills/audit/context/suppression.md @@ -80,6 +80,8 @@ So `.claude/mutation-testing-arid.local.md` is a **draft** file. Describing it a the config" is wrong in exactly the direction that matters. The config's later layers do take effect, and this record's do not. +Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## Obligations this skill must meet 1. **Resolve layers per the cascade**: anchor at the repo root, read every layer that exists, merge diff --git a/plugins/mutation-testing/skills/setup/SKILL.md b/plugins/mutation-testing/skills/setup/SKILL.md index e641ae9a619..c8efe03663c 100644 --- a/plugins/mutation-testing/skills/setup/SKILL.md +++ b/plugins/mutation-testing/skills/setup/SKILL.md @@ -28,6 +28,8 @@ The config resolves across three layers, lowest first: the user layer (`userConf `${CLAUDE_PLUGIN_ROOT}/schemas/mutation-testing.schema.json`) → personal override (`.claude/mutation-testing.local.md`), later layers overriding scalars and unioning lists. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + The team file of earlier releases, .claude/mutation-testing.md, is retired and never read as a layer. While it exists, `check` probe 6 reports it as INFO, which gates nothing, naming `apply` as the move, or, once the YAML file exists, deleting it; `apply` step 7 carries its keys over. diff --git a/plugins/overengineering/reference/consumer-config.md b/plugins/overengineering/reference/consumer-config.md index f4b96ecf770..de3c07536ea 100644 --- a/plugins/overengineering/reference/consumer-config.md +++ b/plugins/overengineering/reference/consumer-config.md @@ -31,6 +31,8 @@ Three layers, resolved in this order: | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/overengineering.md` | | 3 | personal override (gitignored) | `${CLAUDE_PROJECT_DIR}/.claude/overengineering.local.md` | +Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + **Merge form: per-key override**, declared here as the cascade convention requires. The values are scalars and closed mappings, where concatenation is meaningless: a later layer replaces an earlier layer's value key by key, a key absent from a later layer keeps the earlier value, and wholesale diff --git a/plugins/plugin-quality/reference/config.md b/plugins/plugin-quality/reference/config.md index aacf7a7d0c4..2ac7986ac30 100644 --- a/plugins/plugin-quality/reference/config.md +++ b/plugins/plugin-quality/reference/config.md @@ -30,6 +30,8 @@ layer and **no personal override channel**; the old layers are retired, each wit | personal override | `.claude/plugin-quality.local.md` | record `plugin-quality-r002` (delete). Never read; setup `check` WARNs while it exists rather than silently ignoring it. | | user-global | `~/.claude/plugin-quality.md` | machine scope, outside the retirement manifest by contract. Never read; setup `check` WARNs in prose when it exists. | +Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## Resolution order 1. The convention home resolves (resolver exit 0) and `/plugin-quality/README.md` exists → diff --git a/plugins/plugin-quality/skills/setup/SKILL.md b/plugins/plugin-quality/skills/setup/SKILL.md index 9944f16053c..08a13c925ad 100644 --- a/plugins/plugin-quality/skills/setup/SKILL.md +++ b/plugins/plugin-quality/skills/setup/SKILL.md @@ -79,6 +79,8 @@ against that contract rather than restating it. 6. **Sink reachability**. For the effective sink: `gh-issues` → covered by step 1; `markdown-dir` → the directory exists and is writable; `local-fallback` → nothing to check. + Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## `apply` (writes the pointer region + topic doc, on explicit request) Converge, in order, each write individually gated on operator confirmation: diff --git a/plugins/source-control/README.md b/plugins/source-control/README.md index 9a8d4484067..7bc0d9303f1 100644 --- a/plugins/source-control/README.md +++ b/plugins/source-control/README.md @@ -376,6 +376,8 @@ see [hooks: WorktreeRemove](https://code.claude.com/docs/en/hooks#worktreeremove rules. Defaults (Conventional Commits, squash merge) apply only when the project declares nothing. + Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## Requirements - **shfmt v3.14.1 or later**, which the PR-linkage and worktree gates read commands through. diff --git a/plugins/source-control/reference/config-resolution.md b/plugins/source-control/reference/config-resolution.md index aa959fcc77d..f8c8d5664d6 100644 --- a/plugins/source-control/reference/config-resolution.md +++ b/plugins/source-control/reference/config-resolution.md @@ -744,6 +744,8 @@ Layers, in resolution order, where a later layer refines an earlier one: 3. **`${REPO_ROOT}/.claude/source-control.local.md`**: personal override, gitignored. A per-machine or per-operator deviation from team policy, never committed. + Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + Each layer is optional, and **fall-through is per key, not per file**. A key absent from every layer is unresolved even when some layer exists: a user-global file contributing only `trailer_policy` leaves `subject_pattern` as unresolved as no file at all. Each unresolved key falls through diff --git a/plugins/source-control/skills/commit/SKILL.md b/plugins/source-control/skills/commit/SKILL.md index 004a75ab7cc..80b009196d2 100644 --- a/plugins/source-control/skills/commit/SKILL.md +++ b/plugins/source-control/skills/commit/SKILL.md @@ -14,6 +14,8 @@ metadata: Exec-bit backstop: !`bash "${CLAUDE_PLUGIN_ROOT}/skills/commit/scripts/exec-bit-check.sh" --probe 2>/dev/null || echo "unavailable — run the check manually"` Config layer (user-global): !`test -f "$HOME/.claude/source-control.md" && echo present || echo absent` +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ## Repository context. Gather first Collect these with **individual** Bash calls, one command per call, never combined into a single diff --git a/plugins/source-control/skills/commit/reference/config-probes.md b/plugins/source-control/skills/commit/reference/config-probes.md index f3ef8ba62da..ed4b1f8aac9 100644 --- a/plugins/source-control/skills/commit/reference/config-probes.md +++ b/plugins/source-control/skills/commit/reference/config-probes.md @@ -53,3 +53,5 @@ substitutes the root at all. This matches the root-resolution requirement [`config-resolution.md`](../../../reference/config-resolution.md) already states for resolution itself; the probes must not disagree with it. `exec-bit-check.sh` anchors itself the same way. + +Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. diff --git a/plugins/source-control/skills/setup/SKILL.md b/plugins/source-control/skills/setup/SKILL.md index 0a70f80e987..687de86845d 100644 --- a/plugins/source-control/skills/setup/SKILL.md +++ b/plugins/source-control/skills/setup/SKILL.md @@ -128,6 +128,8 @@ Per-layer verdicts: remediations, so probe them separately. See the two-probe form under `apply`. Absent file is OK once the ignore rule itself is present. + Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + **FAIL** when the *effective* `subject_pattern` is not machine-checkable. It must be either the literal keyword `Conventional Commits` or an anchored regex (`^…`-style); a plain-language description cannot be evaluated by `/source-control:commit` or `/source-control:pull-request`. Name the layer that supplied the diff --git a/plugins/source-control/skills/setup/reference/apply-convention.md b/plugins/source-control/skills/setup/reference/apply-convention.md index d2ee7250e8b..a8733049d32 100644 --- a/plugins/source-control/skills/setup/reference/apply-convention.md +++ b/plugins/source-control/skills/setup/reference/apply-convention.md @@ -39,6 +39,8 @@ absent, since a convention is a team artifact until someone says otherwise. | `team` (default) | `REPO_ROOT/docs/conventions/source-control.yaml` | the shared, tracked convention | | `local` | `REPO_ROOT/.claude/source-control.local.md` | a personal deviation from team policy here | +Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + The team layer is YAML, validated by `plugins/source-control/schemas/source-control.schema.json` ([config-resolution.md](../../../reference/config-resolution.md), "The config files"). The user and local layers stay markdown, one `## ` section per key. The retired team file diff --git a/plugins/testing/README.md b/plugins/testing/README.md index 834fbe29aff..a961b53d67e 100644 --- a/plugins/testing/README.md +++ b/plugins/testing/README.md @@ -139,6 +139,8 @@ lower it: the lowest valid value wins, a raise is reported as ignored, and an in named and dropped. A testing release without this key stops its test scan on `pixel_tolerance` in `testing.yaml`, so add the map once every member runs this release. +Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + `verification` (`off | light | standard | strict`, default `light`) and `verification_skills` (per-skill levels; an entry beats `verification`) set whether `/testing:cleanup`'s Cannot-fail-only mode dispatches its fresh-context skeptic: under `light` and `off` it dispatches none and deletes nothing. diff --git a/plugins/testing/skills/check-visual-parity/SKILL.md b/plugins/testing/skills/check-visual-parity/SKILL.md index 5ec61638fd3..2d89b131104 100644 --- a/plugins/testing/skills/check-visual-parity/SKILL.md +++ b/plugins/testing/skills/check-visual-parity/SKILL.md @@ -92,6 +92,8 @@ The user-global `~/.claude/testing.yaml`, the personal override `.claude/testing (`source=personal-override`) and the plugin option can only lower the team value. The script reports a raise as ignored, and names an invalid layer and drops it. Quote a `reason` that holds a colon followed by a space. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + A tolerance above 0 is used only with its recorded reason; never pass a higher `--tolerance` than this line gives. To keep a known baseline mismatch under tolerance, the team records a `pixel_tolerance` map with the pixel count and a reason in `docs/conventions/testing.yaml`; this diff --git a/plugins/testing/skills/run-e2e/SKILL.md b/plugins/testing/skills/run-e2e/SKILL.md index 4c799619d2f..cc36cf816e8 100644 --- a/plugins/testing/skills/run-e2e/SKILL.md +++ b/plugins/testing/skills/run-e2e/SKILL.md @@ -142,6 +142,8 @@ A legacy testing-format map (`.claude/skills/feature-map/SKILL.md`, or the direc not read. Warn that it is present and name `/app-control:map refresh `, which converts it; the run continues. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + ### Entry points The touched features are the `features` list of `affected.json`. Drive every entry point each one diff --git a/plugins/testing/skills/run-e2e/context/e2e-config.md b/plugins/testing/skills/run-e2e/context/e2e-config.md index 8baab98e108..1d723ac6e68 100644 --- a/plugins/testing/skills/run-e2e/context/e2e-config.md +++ b/plugins/testing/skills/run-e2e/context/e2e-config.md @@ -13,6 +13,8 @@ visible, who drives, and whether it drives an app already running. The keys live `~/.claude/testing.yaml`, and personal override `.claude/testing.local.yaml`; per user, the plugin `userConfig` options of the same names. `scripts/resolve-config.sh e2e` resolves them. + Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + All five keys govern only this skill's own driving ([own-driving.md](own-driving.md)). When a run goes through `/app-control:drive` (SKILL.md Step 1), the app's control skill, which `/app-control:map create` writes, supplies the driver, the reuse of a running instance and the diff --git a/plugins/testing/skills/setup/SKILL.md b/plugins/testing/skills/setup/SKILL.md index f95b75c63bb..9c5638a44b1 100644 --- a/plugins/testing/skills/setup/SKILL.md +++ b/plugins/testing/skills/setup/SKILL.md @@ -28,6 +28,8 @@ with `*` must be single-quoted. `docs/conventions/testing.yaml` also holds `/tes `map_report_order`, `file_findings` and `file_findings_floor`, and `/testing:write`'s `tdd_refactor_step` and `first_test`, which the scan ignores. +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + The keys: ```yaml diff --git a/plugins/testing/skills/write/SKILL.md b/plugins/testing/skills/write/SKILL.md index 17a2f4fdbbe..65c5753831e 100644 --- a/plugins/testing/skills/write/SKILL.md +++ b/plugins/testing/skills/write/SKILL.md @@ -59,6 +59,8 @@ and again in the final summary: Settings: tdd_refactor_step=on (default), first_test=user-flow (docs/conventions/testing.yaml) ``` +Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + [context/write.md](context/write.md) says what each value changes: the Refactor step and its `Refactor checkpoint:` lines, and which test comes first. From 40e53dbc248b542e11391cf0b5382982fcb8c075 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sat, 21 Nov 2026 12:20:56 -0500 Subject: [PATCH 3/8] docs(config-cascade): say the old paths are still read, not where config belongs The pointer now states that the plugin still reads, or reports as retired, the .claude/ paths beside it, and that new config goes where the config locations page says, so a skill-text resolver keeps reading its current path. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015XWwmfSVU9f2by5nqbM3Ak --- docs/contracts/commit-convention/README.md | 2 +- docs/contracts/finding-suppression/README.md | 2 +- docs/contracts/rendered-views/README.md | 2 +- docs/conventions/review-digest.md | 2 +- plugins/attribution/skills/audit/SKILL.md | 2 +- plugins/attribution/skills/setup/SKILL.md | 2 +- plugins/bugs/reference/config.md | 2 +- plugins/bugs/skills/setup/SKILL.md | 2 +- plugins/code-metrics/README.md | 2 +- plugins/code-metrics/reference/config.md | 2 +- plugins/code-metrics/skills/principles/reference/thresholds.md | 2 +- plugins/code-metrics/skills/setup/SKILL.md | 2 +- plugins/codebase-health/README.md | 2 +- plugins/codebase-health/skills/audit/SKILL.md | 2 +- plugins/codebase-health/skills/setup/SKILL.md | 2 +- plugins/discovery/README.md | 2 +- plugins/disk-hygiene/README.md | 2 +- plugins/disk-hygiene/skills/clean/SKILL.md | 2 +- plugins/docs-naming/README.md | 2 +- plugins/docs-naming/reference/config.md | 2 +- plugins/docs-naming/skills/setup/SKILL.md | 2 +- plugins/harness-config/skills/setup/SKILL.md | 2 +- plugins/improvement/README.md | 2 +- plugins/improvement/reference/config.md | 2 +- plugins/improvement/skills/find/context/hotspots.md | 2 +- plugins/improvement/skills/setup/SKILL.md | 2 +- plugins/instruction-placement/reference/consumer-config.md | 2 +- plugins/mutation-testing/skills/audit/context/suppression.md | 2 +- plugins/mutation-testing/skills/setup/SKILL.md | 2 +- plugins/overengineering/reference/consumer-config.md | 2 +- plugins/plugin-quality/reference/config.md | 2 +- plugins/plugin-quality/skills/setup/SKILL.md | 2 +- plugins/source-control/README.md | 2 +- plugins/source-control/reference/config-resolution.md | 2 +- plugins/source-control/skills/commit/SKILL.md | 2 +- plugins/source-control/skills/commit/reference/config-probes.md | 2 +- plugins/source-control/skills/setup/SKILL.md | 2 +- .../source-control/skills/setup/reference/apply-convention.md | 2 +- plugins/testing/README.md | 2 +- plugins/testing/skills/check-visual-parity/SKILL.md | 2 +- plugins/testing/skills/run-e2e/SKILL.md | 2 +- plugins/testing/skills/run-e2e/context/e2e-config.md | 2 +- plugins/testing/skills/setup/SKILL.md | 2 +- plugins/testing/skills/write/SKILL.md | 2 +- 44 files changed, 44 insertions(+), 44 deletions(-) diff --git a/docs/contracts/commit-convention/README.md b/docs/contracts/commit-convention/README.md index 425351312a3..d7e33f533a8 100644 --- a/docs/contracts/commit-convention/README.md +++ b/docs/contracts/commit-convention/README.md @@ -59,7 +59,7 @@ name the file to change. it: an operator who wants `/source-control:commit` to draft to the same pattern also sets `## subject_pattern` in the drafting personal override, `.claude/source-control.local.md`. - Where plugin config belongs: [config locations](../config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. + A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../config-cascade/locations.md) says. The folder-form file, and its fail-closed checks, are read only for a key the YAML lacks: a broken folder-form file never disables a key the YAML supplies. Each key holds exactly one diff --git a/docs/contracts/finding-suppression/README.md b/docs/contracts/finding-suppression/README.md index e675d2238c4..a5a13295671 100644 --- a/docs/contracts/finding-suppression/README.md +++ b/docs/contracts/finding-suppression/README.md @@ -33,7 +33,7 @@ The consuming plugin names its own surface. The first adopter, `harness-config`' | 2 | team (tracked) | `/harness-config.yaml` (`` from the convention-home pointer line, default `docs/conventions`) | | 3 | personal override (gitignored) | `.claude/audit-pass.local.md` | -Where plugin config belongs: [config locations](../config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. +A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../config-cascade/locations.md) says. In a YAML concern file the `suppressions` mapping sits at the root with the entry shape below; a reader that uses the shared YAML-subset parser needs the `"anchor/v1":` key quoted. diff --git a/docs/contracts/rendered-views/README.md b/docs/contracts/rendered-views/README.md index e2a40d71a39..2c0790352a7 100644 --- a/docs/contracts/rendered-views/README.md +++ b/docs/contracts/rendered-views/README.md @@ -928,7 +928,7 @@ lane. A skill runs its `resolve` command and never reads the files itself. chain). Each lane registers once in the medium registry with its view kinds, whether it is hosted-capable, and its default. - Where plugin config belongs: [config locations](../config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. + A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../config-cascade/locations.md) says. ## Template vendoring posture diff --git a/docs/conventions/review-digest.md b/docs/conventions/review-digest.md index ac381c31eb4..d55d50e7a6f 100644 --- a/docs/conventions/review-digest.md +++ b/docs/conventions/review-digest.md @@ -55,7 +55,7 @@ an earlier one key by key: the layer below. 3. personal override `.claude/review-digest.local.json` - Where plugin config belongs: [config locations](../contracts/config-cascade/locations.md). A `.claude/` path named here is a plugin's current or retired location, a declared deviation until it migrates. + A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../contracts/config-cascade/locations.md) says. The result names the layer that supplied each value (`team :`, `user-global `, `personal-override `, or `default`). Quote glob values in the YAML file (`"**/hooks/**"`), diff --git a/plugins/attribution/skills/audit/SKILL.md b/plugins/attribution/skills/audit/SKILL.md index 3d46cd1aff2..43d79c200ed 100644 --- a/plugins/attribution/skills/audit/SKILL.md +++ b/plugins/attribution/skills/audit/SKILL.md @@ -313,7 +313,7 @@ layer supplying every effective value. The accuracy dials (`nomination_passes`, tunable per repo; the gates bind fix eligibility and release readiness only, and never filter what the report shows. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. When `deep_research_on_exhaustion` is on and a research-capable skill is enabled, a budget-exhausted candidate may escalate to `/discovery:research` (if that plugin is enabled). diff --git a/plugins/attribution/skills/setup/SKILL.md b/plugins/attribution/skills/setup/SKILL.md index c8124a26008..ad6efbf71d3 100644 --- a/plugins/attribution/skills/setup/SKILL.md +++ b/plugins/attribution/skills/setup/SKILL.md @@ -94,7 +94,7 @@ an earlier one: | 2 | team | `//attribution.yaml` | the repository, tracked | | 3 | personal override | `//attribution.local.yaml` | one operator in one repo, gitignored | -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. `apply` writes only the team layer and the personal override, never the user-global file. Before it writes the personal override, `git check-ignore -q "//attribution.local.yaml"` must exit 0; when diff --git a/plugins/bugs/reference/config.md b/plugins/bugs/reference/config.md index 644cd884911..d3b8c3718f8 100644 --- a/plugins/bugs/reference/config.md +++ b/plugins/bugs/reference/config.md @@ -18,7 +18,7 @@ Three layers, resolved in this order, where a later layer refines an earlier one | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/docs/conventions/bugs.yaml` for the keys; `${CLAUDE_PROJECT_DIR}/docs/conventions/bugs.md` for prose and `## Gotchas` | must be tracked, the only layer teammates receive | | 3 | personal override | `${CLAUDE_PROJECT_DIR}/.claude/bugs.local.md` | must be gitignored, never staged | -Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. The team files sit in `docs/conventions/` whatever convention home the repository binds; a repository that binds another home still keeps them there. diff --git a/plugins/bugs/skills/setup/SKILL.md b/plugins/bugs/skills/setup/SKILL.md index b5e132b5a83..a3e29f08339 100644 --- a/plugins/bugs/skills/setup/SKILL.md +++ b/plugins/bugs/skills/setup/SKILL.md @@ -124,7 +124,7 @@ never written. already covered. 7. **Remind them to stage it.** The team file reaches teammates only once committed. - Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. Re-running `apply` when everything already matches changes nothing and reports "already configured". diff --git a/plugins/code-metrics/README.md b/plugins/code-metrics/README.md index 45cab675234..f91d7bc3d4e 100644 --- a/plugins/code-metrics/README.md +++ b/plugins/code-metrics/README.md @@ -88,7 +88,7 @@ and `enabled`. References ship with their provenance: cyclomatic 20 cites ISO/IE a documented YAML subset (block style, flow sequences of scalars, no flow mappings). Every key: `reference/config.md`; `/code-metrics:setup` writes the team layer and probes the collectors. -Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. ## The report diff --git a/plugins/code-metrics/reference/config.md b/plugins/code-metrics/reference/config.md index 3f29122400c..b6703bb0875 100644 --- a/plugins/code-metrics/reference/config.md +++ b/plugins/code-metrics/reference/config.md @@ -17,7 +17,7 @@ resolved in this order over the bundled defaults (`scripts/config-defaults.json` | 2 | team | `/docs/conventions/code-metrics.yaml` | the repository, tracked | | 3 | personal override | `/.claude/code-metrics.local.yaml` | one operator in one repository, gitignored | -Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. The team layer is `docs/conventions/code-metrics.yaml` alone. The team file earlier releases read from the repository's `.claude/` directory is retired and never read. `/code-metrics:setup check` diff --git a/plugins/code-metrics/skills/principles/reference/thresholds.md b/plugins/code-metrics/skills/principles/reference/thresholds.md index a4da0497348..bbf9de59cd3 100644 --- a/plugins/code-metrics/skills/principles/reference/thresholds.md +++ b/plugins/code-metrics/skills/principles/reference/thresholds.md @@ -94,7 +94,7 @@ rest of the defaults intact. The full key list is [`reference/config.md`](../../ that supplied any value a personal layer changed, so a number that differs from a teammate's is traceable to the layer that changed it rather than to the code. -Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. Setting a reference to `null` is a legitimate choice and turns the count off while the measure keeps reporting. Setting one to a value you can defend for your codebase is a better choice than adopting diff --git a/plugins/code-metrics/skills/setup/SKILL.md b/plugins/code-metrics/skills/setup/SKILL.md index 82b07fa5769..f34e56670b8 100644 --- a/plugins/code-metrics/skills/setup/SKILL.md +++ b/plugins/code-metrics/skills/setup/SKILL.md @@ -20,7 +20,7 @@ surface and for the external collectors the audits probe: `check` inspects and v persists, and neither installs anything. Keys, defaults, and provenance: `${CLAUDE_PLUGIN_ROOT}/reference/config.md`. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. Action routing: no argument or `check` runs the check; `apply` runs the check first, then persists. `apply` is non-interactive when complete `=` arguments are supplied diff --git a/plugins/codebase-health/README.md b/plugins/codebase-health/README.md index 8c2ad71c986..8c663eca763 100644 --- a/plugins/codebase-health/README.md +++ b/plugins/codebase-health/README.md @@ -58,7 +58,7 @@ it>)`, and any notice. A `terminal` result drops the offer. The tracked team fil new home; a `terminal` or `file` value in one still keeps the view local when no other setting decides, and a publishing value there is ignored. -Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. ## Configurable audit dimensions diff --git a/plugins/codebase-health/skills/audit/SKILL.md b/plugins/codebase-health/skills/audit/SKILL.md index 2f85bab63cc..ec43d5f9447 100644 --- a/plugins/codebase-health/skills/audit/SKILL.md +++ b/plugins/codebase-health/skills/audit/SKILL.md @@ -113,7 +113,7 @@ pass). Come from the consuming repo's tracked config, resolved additively across 2. `.claude/codebase-health.md` (team, tracked) 3. `.claude/codebase-health.local.md` (personal override, gitignored) - Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. The four bundled dimensions are `documentation`, `configuration`, `code-quality`, and `architecture`; the config may tune their globs, remove a dimension, or add custom ones. diff --git a/plugins/codebase-health/skills/setup/SKILL.md b/plugins/codebase-health/skills/setup/SKILL.md index 9286bfe9d13..9581cc1fc3d 100644 --- a/plugins/codebase-health/skills/setup/SKILL.md +++ b/plugins/codebase-health/skills/setup/SKILL.md @@ -25,7 +25,7 @@ earlier layer's and example-claims concatenate, **except** that a later layer de with empty source lists is an explicit opt-out that *removes* that inherited dimension. This skill writes only the **team** file; changes to the user-global layer or the personal override are the user's to make. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. ## `check` (read-only) diff --git a/plugins/discovery/README.md b/plugins/discovery/README.md index 1b8f49522b4..1626b01d4c1 100644 --- a/plugins/discovery/README.md +++ b/plugins/discovery/README.md @@ -160,7 +160,7 @@ because a spawn's `model` takes an alias only ([sub-agents: choose a model](https://code.claude.com/docs/en/sub-agents#choose-a-model)). With no such layer, or without `multi-agent`, the pins apply. The rule: `reference/parent-contract.md`, "The worker's model is the parent's call". -Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. diff --git a/plugins/disk-hygiene/README.md b/plugins/disk-hygiene/README.md index 74d9adfe7f8..81c41747d83 100644 --- a/plugins/disk-hygiene/README.md +++ b/plugins/disk-hygiene/README.md @@ -387,7 +387,7 @@ Without `--policy`, standing policy files layer over the baseline when present: `.claude/disk-hygiene.json`. An explicit `--policy` file is the invocation-specific choice and replaces both standing layers. The scan output records which sources applied. -Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. Candidate hints can be disabled or extended. Consumer protection globs are additive. A relative glob matches a path relative to the scan target. A glob that starts with `/`, a drive letter, or `\\` (a UNC path such as `\\server\share\keep\**`) matches the absolute path, so a standing overlay can protect a tree no matter which parent is scanned. An object `{glob, reason}` is accepted. For every entry that matches a path, the scan entry, the preview candidate, the handoff-verify verdict, and a skipped apply path list it under `protection_matches`, sorted and deduplicated, as `{glob}` or `{glob, reason}`. That field sits beside the `consumer-protected-path` reason and is absent when no entry matched. Hard safety predicates and the baseline protected-name/root rules are non-overridable by any layer: a policy diff --git a/plugins/disk-hygiene/skills/clean/SKILL.md b/plugins/disk-hygiene/skills/clean/SKILL.md index fda5bcb3ead..6e279a0a0fa 100644 --- a/plugins/disk-hygiene/skills/clean/SKILL.md +++ b/plugins/disk-hygiene/skills/clean/SKILL.md @@ -233,7 +233,7 @@ and `elevation`; none can weaken hard guards. The [overlay schema](reference/pol lists every field; version 1 files load unchanged. The scan output names its `policy_sources` and the effective `elevation`. Scan errors and unvisited protected roots are coverage gaps, not clean. A hint's `entry_types` and the snapshot's `empty_directory_paths` are in [scan-flags.md](reference/scan-flags.md#coverage-and-hint-fields). -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. The scan output may also carry an `os_autoclean` advisory when the target overlaps a zone an OS mechanism (Windows Storage Sense, systemd-tmpfiles) should own. Surface its recommendation in the diff --git a/plugins/docs-naming/README.md b/plugins/docs-naming/README.md index 98b3c406573..04ec5a3deca 100644 --- a/plugins/docs-naming/README.md +++ b/plugins/docs-naming/README.md @@ -51,7 +51,7 @@ into it. A user-global file still at the retired `docs-hygiene` name (`~/.claude/docs-hygiene.json`) is read, with a warning from the resolver; rename it to retire the warning. -Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. ## Renames are gated per file diff --git a/plugins/docs-naming/reference/config.md b/plugins/docs-naming/reference/config.md index edcd3aaf83d..43a86adc27e 100644 --- a/plugins/docs-naming/reference/config.md +++ b/plugins/docs-naming/reference/config.md @@ -53,7 +53,7 @@ A user-global file absent under `docs-naming.json` but present under the retired stderr warning from `resolve` and a WARN row from `/docs-naming:setup check`. The new name wins when both exist. Rename the file to retire the warning. -Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. All three absent is a valid state: every key has a bundled default, and the defaults are this marketplace's own values, except `generated`, which is empty. The recommended gitignore line for diff --git a/plugins/docs-naming/skills/setup/SKILL.md b/plugins/docs-naming/skills/setup/SKILL.md index 1b5ba176e5f..2de26bcd134 100644 --- a/plugins/docs-naming/skills/setup/SKILL.md +++ b/plugins/docs-naming/skills/setup/SKILL.md @@ -85,7 +85,7 @@ no cleanup, since neither file is read; the old-file rows name the next step. Th layer row reports it as WARN with the same remedy: rename it to `docs-naming.json` in the same directory. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. ## `apply` (idempotent) diff --git a/plugins/harness-config/skills/setup/SKILL.md b/plugins/harness-config/skills/setup/SKILL.md index a8841531f76..d172fdc3467 100644 --- a/plugins/harness-config/skills/setup/SKILL.md +++ b/plugins/harness-config/skills/setup/SKILL.md @@ -127,7 +127,7 @@ tracked/ignored question has opposite correct answers per layer, so verify each - **personal override** `.claude/audit-pass.local.md`: must be gitignored and never staged. Staged or tracked is a FAIL: a personal deviation can reach team history. - Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. Parse each present layer and report as malformed any entry missing **any** of its five required keys: `check`, `claim`, `sites`, `reason`, `date`. Checking only `reason` and `date` would pass an diff --git a/plugins/improvement/README.md b/plugins/improvement/README.md index 9bf4978ca98..f83f610aa17 100644 --- a/plugins/improvement/README.md +++ b/plugins/improvement/README.md @@ -45,7 +45,7 @@ churn analysis or declare Tier 2 MCP telemetry sources, run `/improvement:setup` the team `.claude/improvement.md`, then the gitignored `.claude/improvement.local.md` personal override. The key contract lives in [reference/config.md](reference/config.md). -Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. ## Running it as a standing routine diff --git a/plugins/improvement/reference/config.md b/plugins/improvement/reference/config.md index 6a717573019..089dd5c38c4 100644 --- a/plugins/improvement/reference/config.md +++ b/plugins/improvement/reference/config.md @@ -17,7 +17,7 @@ Three layers, resolved in this order, where a later layer refines an earlier one | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/improvement.md` | must be tracked, the only layer teammates receive | | 3 | personal override | `${CLAUDE_PROJECT_DIR}/.claude/improvement.local.md` | must be gitignored, never staged | -Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. Resolution anchors at the repo root, `${CLAUDE_PROJECT_DIR}` when set and otherwise `git rev-parse --show-toplevel`, never at the CWD. Every layer that exists is read and merged; diff --git a/plugins/improvement/skills/find/context/hotspots.md b/plugins/improvement/skills/find/context/hotspots.md index 44ee671a5f5..4ef892d33d9 100644 --- a/plugins/improvement/skills/find/context/hotspots.md +++ b/plugins/improvement/skills/find/context/hotspots.md @@ -83,7 +83,7 @@ Step 1's `excludes` as one ERE, alternatives joined with `|`, from two sources: The scan asks nothing and writes no record; `/improvement:setup apply` offers to persist them as `churn_exclude` entries. - Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. All layers absent is a valid state. When item 2 resolves nothing while `churn_exclude_defaults` is on, record an evidence-gap line (format: unattended.md), e.g. diff --git a/plugins/improvement/skills/setup/SKILL.md b/plugins/improvement/skills/setup/SKILL.md index 31b7a6b98ac..74d8b32d7cc 100644 --- a/plugins/improvement/skills/setup/SKILL.md +++ b/plugins/improvement/skills/setup/SKILL.md @@ -34,7 +34,7 @@ skill writes only the **team** file; changes to the user-global layer or the per user's to make. Anchor every repo-relative read at the repo root (`${CLAUDE_PROJECT_DIR}` when set, otherwise `git rev-parse --show-toplevel`), never at the CWD. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. ## `check` (read-only) diff --git a/plugins/instruction-placement/reference/consumer-config.md b/plugins/instruction-placement/reference/consumer-config.md index e3f08d542d6..8550efa2bd3 100644 --- a/plugins/instruction-placement/reference/consumer-config.md +++ b/plugins/instruction-placement/reference/consumer-config.md @@ -35,7 +35,7 @@ Three layers, resolved in this order: | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/instruction-placement.md` | | 3 | personal override (gitignored) | `${CLAUDE_PROJECT_DIR}/.claude/instruction-placement.local.md` | -Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. **Merge form: per-key override**, declared here as the cascade convention requires. Entries merge per `finding_id`: a later layer's entry for one id wins for that id only, and every id it does not diff --git a/plugins/mutation-testing/skills/audit/context/suppression.md b/plugins/mutation-testing/skills/audit/context/suppression.md index b239b3004f4..1e048584979 100644 --- a/plugins/mutation-testing/skills/audit/context/suppression.md +++ b/plugins/mutation-testing/skills/audit/context/suppression.md @@ -80,7 +80,7 @@ So `.claude/mutation-testing-arid.local.md` is a **draft** file. Describing it a the config" is wrong in exactly the direction that matters. The config's later layers do take effect, and this record's do not. -Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. ## Obligations this skill must meet diff --git a/plugins/mutation-testing/skills/setup/SKILL.md b/plugins/mutation-testing/skills/setup/SKILL.md index c8efe03663c..d69c07a0eea 100644 --- a/plugins/mutation-testing/skills/setup/SKILL.md +++ b/plugins/mutation-testing/skills/setup/SKILL.md @@ -28,7 +28,7 @@ The config resolves across three layers, lowest first: the user layer (`userConf `${CLAUDE_PLUGIN_ROOT}/schemas/mutation-testing.schema.json`) → personal override (`.claude/mutation-testing.local.md`), later layers overriding scalars and unioning lists. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. The team file of earlier releases, .claude/mutation-testing.md, is retired and never read as a layer. While it exists, `check` probe 6 reports it as INFO, which gates nothing, naming `apply` as the move, or, once diff --git a/plugins/overengineering/reference/consumer-config.md b/plugins/overengineering/reference/consumer-config.md index de3c07536ea..0b8223b015e 100644 --- a/plugins/overengineering/reference/consumer-config.md +++ b/plugins/overengineering/reference/consumer-config.md @@ -31,7 +31,7 @@ Three layers, resolved in this order: | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/overengineering.md` | | 3 | personal override (gitignored) | `${CLAUDE_PROJECT_DIR}/.claude/overengineering.local.md` | -Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. **Merge form: per-key override**, declared here as the cascade convention requires. The values are scalars and closed mappings, where concatenation is meaningless: a later layer replaces an earlier diff --git a/plugins/plugin-quality/reference/config.md b/plugins/plugin-quality/reference/config.md index 2ac7986ac30..2d15b7c0640 100644 --- a/plugins/plugin-quality/reference/config.md +++ b/plugins/plugin-quality/reference/config.md @@ -30,7 +30,7 @@ layer and **no personal override channel**; the old layers are retired, each wit | personal override | `.claude/plugin-quality.local.md` | record `plugin-quality-r002` (delete). Never read; setup `check` WARNs while it exists rather than silently ignoring it. | | user-global | `~/.claude/plugin-quality.md` | machine scope, outside the retirement manifest by contract. Never read; setup `check` WARNs in prose when it exists. | -Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. ## Resolution order diff --git a/plugins/plugin-quality/skills/setup/SKILL.md b/plugins/plugin-quality/skills/setup/SKILL.md index 08a13c925ad..113e156e823 100644 --- a/plugins/plugin-quality/skills/setup/SKILL.md +++ b/plugins/plugin-quality/skills/setup/SKILL.md @@ -79,7 +79,7 @@ against that contract rather than restating it. 6. **Sink reachability**. For the effective sink: `gh-issues` → covered by step 1; `markdown-dir` → the directory exists and is writable; `local-fallback` → nothing to check. - Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. ## `apply` (writes the pointer region + topic doc, on explicit request) diff --git a/plugins/source-control/README.md b/plugins/source-control/README.md index 7bc0d9303f1..01612c53ab3 100644 --- a/plugins/source-control/README.md +++ b/plugins/source-control/README.md @@ -376,7 +376,7 @@ see [hooks: WorktreeRemove](https://code.claude.com/docs/en/hooks#worktreeremove rules. Defaults (Conventional Commits, squash merge) apply only when the project declares nothing. - Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. ## Requirements diff --git a/plugins/source-control/reference/config-resolution.md b/plugins/source-control/reference/config-resolution.md index f8c8d5664d6..ac71559bc89 100644 --- a/plugins/source-control/reference/config-resolution.md +++ b/plugins/source-control/reference/config-resolution.md @@ -744,7 +744,7 @@ Layers, in resolution order, where a later layer refines an earlier one: 3. **`${REPO_ROOT}/.claude/source-control.local.md`**: personal override, gitignored. A per-machine or per-operator deviation from team policy, never committed. - Where plugin config belongs: [config locations](config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. Each layer is optional, and **fall-through is per key, not per file**. A key absent from every layer is unresolved even when some layer exists: a user-global file contributing only `trailer_policy` diff --git a/plugins/source-control/skills/commit/SKILL.md b/plugins/source-control/skills/commit/SKILL.md index 80b009196d2..9d122713c18 100644 --- a/plugins/source-control/skills/commit/SKILL.md +++ b/plugins/source-control/skills/commit/SKILL.md @@ -14,7 +14,7 @@ metadata: Exec-bit backstop: !`bash "${CLAUDE_PLUGIN_ROOT}/skills/commit/scripts/exec-bit-check.sh" --probe 2>/dev/null || echo "unavailable — run the check manually"` Config layer (user-global): !`test -f "$HOME/.claude/source-control.md" && echo present || echo absent` -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. ## Repository context. Gather first diff --git a/plugins/source-control/skills/commit/reference/config-probes.md b/plugins/source-control/skills/commit/reference/config-probes.md index ed4b1f8aac9..f2914110812 100644 --- a/plugins/source-control/skills/commit/reference/config-probes.md +++ b/plugins/source-control/skills/commit/reference/config-probes.md @@ -54,4 +54,4 @@ substitutes the root at all. This matches the root-resolution requirement already states for resolution itself; the probes must not disagree with it. `exec-bit-check.sh` anchors itself the same way. -Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. diff --git a/plugins/source-control/skills/setup/SKILL.md b/plugins/source-control/skills/setup/SKILL.md index 687de86845d..3285d68bbf5 100644 --- a/plugins/source-control/skills/setup/SKILL.md +++ b/plugins/source-control/skills/setup/SKILL.md @@ -128,7 +128,7 @@ Per-layer verdicts: remediations, so probe them separately. See the two-probe form under `apply`. Absent file is OK once the ignore rule itself is present. - Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. **FAIL** when the *effective* `subject_pattern` is not machine-checkable. It must be either the literal keyword `Conventional Commits` or an anchored regex (`^…`-style); a plain-language diff --git a/plugins/source-control/skills/setup/reference/apply-convention.md b/plugins/source-control/skills/setup/reference/apply-convention.md index a8733049d32..0d3a1526ed2 100644 --- a/plugins/source-control/skills/setup/reference/apply-convention.md +++ b/plugins/source-control/skills/setup/reference/apply-convention.md @@ -39,7 +39,7 @@ absent, since a convention is a team artifact until someone says otherwise. | `team` (default) | `REPO_ROOT/docs/conventions/source-control.yaml` | the shared, tracked convention | | `local` | `REPO_ROOT/.claude/source-control.local.md` | a personal deviation from team policy here | -Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. The team layer is YAML, validated by `plugins/source-control/schemas/source-control.schema.json` ([config-resolution.md](../../../reference/config-resolution.md), "The config files"). The user diff --git a/plugins/testing/README.md b/plugins/testing/README.md index a961b53d67e..d7f730630d6 100644 --- a/plugins/testing/README.md +++ b/plugins/testing/README.md @@ -139,7 +139,7 @@ lower it: the lowest valid value wins, a raise is reported as ignored, and an in named and dropped. A testing release without this key stops its test scan on `pixel_tolerance` in `testing.yaml`, so add the map once every member runs this release. -Where plugin config belongs: [config locations](reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. `verification` (`off | light | standard | strict`, default `light`) and `verification_skills` (per-skill levels; an entry beats `verification`) set whether `/testing:cleanup`'s Cannot-fail-only mode diff --git a/plugins/testing/skills/check-visual-parity/SKILL.md b/plugins/testing/skills/check-visual-parity/SKILL.md index 2d89b131104..3ea206ec28e 100644 --- a/plugins/testing/skills/check-visual-parity/SKILL.md +++ b/plugins/testing/skills/check-visual-parity/SKILL.md @@ -92,7 +92,7 @@ The user-global `~/.claude/testing.yaml`, the personal override `.claude/testing (`source=personal-override`) and the plugin option can only lower the team value. The script reports a raise as ignored, and names an invalid layer and drops it. Quote a `reason` that holds a colon followed by a space. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. A tolerance above 0 is used only with its recorded reason; never pass a higher `--tolerance` than this line gives. To keep a known baseline mismatch under tolerance, the team records a diff --git a/plugins/testing/skills/run-e2e/SKILL.md b/plugins/testing/skills/run-e2e/SKILL.md index cc36cf816e8..036ab97fba6 100644 --- a/plugins/testing/skills/run-e2e/SKILL.md +++ b/plugins/testing/skills/run-e2e/SKILL.md @@ -142,7 +142,7 @@ A legacy testing-format map (`.claude/skills/feature-map/SKILL.md`, or the direc not read. Warn that it is present and name `/app-control:map refresh `, which converts it; the run continues. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. ### Entry points diff --git a/plugins/testing/skills/run-e2e/context/e2e-config.md b/plugins/testing/skills/run-e2e/context/e2e-config.md index 1d723ac6e68..a665ad26bad 100644 --- a/plugins/testing/skills/run-e2e/context/e2e-config.md +++ b/plugins/testing/skills/run-e2e/context/e2e-config.md @@ -13,7 +13,7 @@ visible, who drives, and whether it drives an app already running. The keys live `~/.claude/testing.yaml`, and personal override `.claude/testing.local.yaml`; per user, the plugin `userConfig` options of the same names. `scripts/resolve-config.sh e2e` resolves them. - Where plugin config belongs: [config locations](../../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. + This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. All five keys govern only this skill's own driving ([own-driving.md](own-driving.md)). When a run goes through `/app-control:drive` (SKILL.md Step 1), the app's control skill, which diff --git a/plugins/testing/skills/setup/SKILL.md b/plugins/testing/skills/setup/SKILL.md index 9c5638a44b1..d428687187e 100644 --- a/plugins/testing/skills/setup/SKILL.md +++ b/plugins/testing/skills/setup/SKILL.md @@ -28,7 +28,7 @@ with `*` must be single-quoted. `docs/conventions/testing.yaml` also holds `/tes `map_report_order`, `file_findings` and `file_findings_floor`, and `/testing:write`'s `tdd_refactor_step` and `first_test`, which the scan ignores. -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. The keys: diff --git a/plugins/testing/skills/write/SKILL.md b/plugins/testing/skills/write/SKILL.md index 65c5753831e..ca2af2e048d 100644 --- a/plugins/testing/skills/write/SKILL.md +++ b/plugins/testing/skills/write/SKILL.md @@ -59,7 +59,7 @@ and again in the final summary: Settings: tdd_refactor_step=on (default), first_test=user-flow (docs/conventions/testing.yaml) ``` -Where plugin config belongs: [config locations](../../reference/config-locations.md). A `.claude/` path named here is this plugin's current or retired location, a declared deviation until it migrates. +This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. [context/write.md](context/write.md) says what each value changes: the Refactor step and its `Refactor checkpoint:` lines, and which test comes first. From 1d043e02a41abdc1ea44c5694b33fb35f469e5b4 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sat, 21 Nov 2026 12:31:58 -0500 Subject: [PATCH 4/8] docs(config-cascade): keep config-locations copies only where a doc cites them The 39 plugins whose docs cite no reference/config-locations.md lose the generated copy, its registry line and its changelog fragment. The 15 remaining copies are registered as one cross-plugin cluster. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015XWwmfSVU9f2by5nqbM3Ak --- .../adhd/docs-config-locations-10534342.md | 7 --- .../docs-config-locations-a8e694e1.md | 7 --- .../ai-slop/docs-config-locations-9a460e7b.md | 7 --- .../docs-config-locations-e5199209.md | 7 --- .../docs-config-locations-44f7a84e.md | 7 --- .../docs-config-locations-66a10e61.md | 7 --- .../docs-config-locations-8c98795d.md | 7 --- .../docs-config-locations-a26656d1.md | 7 --- .../docs-config-locations-e943110a.md | 7 --- .../docs-config-locations-98a10919.md | 7 --- .../docs-config-locations-b434a16e.md | 7 --- .../docs-config-locations-9f24c799.md | 7 --- .../docs-config-locations-9995658b.md | 7 --- .../docs-config-locations-47828876.md | 7 --- .../docs-config-locations-306a4e1d.md | 7 --- .../docs-config-locations-f658770a.md | 7 --- .../docs-config-locations-9397920f.md | 7 --- .../fleet/docs-config-locations-95087e01.md | 7 --- .../docs-config-locations-c1c046d9.md | 7 --- .../docs-config-locations-e8373e15.md | 7 --- .../docs-config-locations-2869d22d.md | 7 --- .../docs-config-locations-b6289359.md | 7 --- .../docs-config-locations-6e40087b.md | 7 --- .../docs-config-locations-23f09539.md | 7 --- .../miro/docs-config-locations-4f670824.md | 7 --- .../docs-config-locations-5d9b0546.md | 7 --- .../docs-config-locations-40d672b5.md | 7 --- .../docs-config-locations-4954f57b.md | 7 --- .../docs-config-locations-9208470f.md | 7 --- .../docs-config-locations-6441774a.md | 7 --- .../docs-config-locations-c5e37034.md | 7 --- .../docs-config-locations-24e64470.md | 7 --- .../docs-config-locations-51682f29.md | 7 --- .../review/docs-config-locations-0c394252.md | 7 --- .../docs-config-locations-31a0c9e7.md | 7 --- .../docs-config-locations-a0a6a1c5.md | 7 --- .../docs-config-locations-2f4a2460.md | 7 --- .../docs-config-locations-5507d073.md | 7 --- .../docs-config-locations-1789468b.md | 7 --- plugins/adhd/reference/config-locations.md | 47 ------------------- .../ai-briefing/reference/config-locations.md | 47 ------------------- plugins/ai-slop/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../autonomy/reference/config-locations.md | 47 ------------------- .../bash-format/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../debugging/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../discipline/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../dometrain/reference/config-locations.md | 47 ------------------- .../education/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- plugins/fleet/reference/config-locations.md | 47 ------------------- .../guardrails/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../harness-ops/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- plugins/miro/reference/config-locations.md | 47 ------------------- .../multi-agent/reference/config-locations.md | 47 ------------------- .../performance/reference/config-locations.md | 47 ------------------- .../planning/reference/config-locations.md | 47 ------------------- .../playbooks/reference/config-locations.md | 47 ------------------- .../playwright/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../prototype/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- plugins/review/reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../reference/config-locations.md | 47 ------------------- .../work-items/reference/config-locations.md | 47 ------------------- scripts/cross-plugin-source-registry.txt | 8 ++++ scripts/shared-copies.txt | 39 --------------- 80 files changed, 8 insertions(+), 2145 deletions(-) delete mode 100644 .changes/adhd/docs-config-locations-10534342.md delete mode 100644 .changes/ai-briefing/docs-config-locations-a8e694e1.md delete mode 100644 .changes/ai-slop/docs-config-locations-9a460e7b.md delete mode 100644 .changes/architecture/docs-config-locations-e5199209.md delete mode 100644 .changes/autonomy/docs-config-locations-44f7a84e.md delete mode 100644 .changes/bash-format/docs-config-locations-66a10e61.md delete mode 100644 .changes/code-tidying/docs-config-locations-8c98795d.md delete mode 100644 .changes/context-budget/docs-config-locations-a26656d1.md delete mode 100644 .changes/context-usage/docs-config-locations-e943110a.md delete mode 100644 .changes/debugging/docs-config-locations-98a10919.md delete mode 100644 .changes/desktop-notification/docs-config-locations-b434a16e.md delete mode 100644 .changes/developer-experience/docs-config-locations-9f24c799.md delete mode 100644 .changes/discipline/docs-config-locations-9995658b.md delete mode 100644 .changes/docs-hygiene/docs-config-locations-47828876.md delete mode 100644 .changes/dometrain/docs-config-locations-306a4e1d.md delete mode 100644 .changes/education/docs-config-locations-f658770a.md delete mode 100644 .changes/eol-normalizer/docs-config-locations-9397920f.md delete mode 100644 .changes/fleet/docs-config-locations-95087e01.md delete mode 100644 .changes/guardrails/docs-config-locations-c1c046d9.md delete mode 100644 .changes/harness-memory/docs-config-locations-e8373e15.md delete mode 100644 .changes/harness-ops/docs-config-locations-2869d22d.md delete mode 100644 .changes/javascript-format/docs-config-locations-b6289359.md delete mode 100644 .changes/kindle-dedrm/docs-config-locations-6e40087b.md delete mode 100644 .changes/machine-health/docs-config-locations-23f09539.md delete mode 100644 .changes/miro/docs-config-locations-4f670824.md delete mode 100644 .changes/multi-agent/docs-config-locations-5d9b0546.md delete mode 100644 .changes/performance/docs-config-locations-40d672b5.md delete mode 100644 .changes/planning/docs-config-locations-4954f57b.md delete mode 100644 .changes/playbooks/docs-config-locations-9208470f.md delete mode 100644 .changes/playwright/docs-config-locations-6441774a.md delete mode 100644 .changes/plugin-profiles/docs-config-locations-c5e37034.md delete mode 100644 .changes/prototype/docs-config-locations-24e64470.md delete mode 100644 .changes/repo-hygiene/docs-config-locations-51682f29.md delete mode 100644 .changes/review/docs-config-locations-0c394252.md delete mode 100644 .changes/session-flow/docs-config-locations-31a0c9e7.md delete mode 100644 .changes/skill-quality/docs-config-locations-a0a6a1c5.md delete mode 100644 .changes/user-experience/docs-config-locations-2f4a2460.md delete mode 100644 .changes/visualization/docs-config-locations-5507d073.md delete mode 100644 .changes/work-items/docs-config-locations-1789468b.md delete mode 100644 plugins/adhd/reference/config-locations.md delete mode 100644 plugins/ai-briefing/reference/config-locations.md delete mode 100644 plugins/ai-slop/reference/config-locations.md delete mode 100644 plugins/architecture/reference/config-locations.md delete mode 100644 plugins/autonomy/reference/config-locations.md delete mode 100644 plugins/bash-format/reference/config-locations.md delete mode 100644 plugins/code-tidying/reference/config-locations.md delete mode 100644 plugins/context-budget/reference/config-locations.md delete mode 100644 plugins/context-usage/reference/config-locations.md delete mode 100644 plugins/debugging/reference/config-locations.md delete mode 100644 plugins/desktop-notification/reference/config-locations.md delete mode 100644 plugins/developer-experience/reference/config-locations.md delete mode 100644 plugins/discipline/reference/config-locations.md delete mode 100644 plugins/docs-hygiene/reference/config-locations.md delete mode 100644 plugins/dometrain/reference/config-locations.md delete mode 100644 plugins/education/reference/config-locations.md delete mode 100644 plugins/eol-normalizer/reference/config-locations.md delete mode 100644 plugins/fleet/reference/config-locations.md delete mode 100644 plugins/guardrails/reference/config-locations.md delete mode 100644 plugins/harness-memory/reference/config-locations.md delete mode 100644 plugins/harness-ops/reference/config-locations.md delete mode 100644 plugins/javascript-format/reference/config-locations.md delete mode 100644 plugins/kindle-dedrm/reference/config-locations.md delete mode 100644 plugins/machine-health/reference/config-locations.md delete mode 100644 plugins/miro/reference/config-locations.md delete mode 100644 plugins/multi-agent/reference/config-locations.md delete mode 100644 plugins/performance/reference/config-locations.md delete mode 100644 plugins/planning/reference/config-locations.md delete mode 100644 plugins/playbooks/reference/config-locations.md delete mode 100644 plugins/playwright/reference/config-locations.md delete mode 100644 plugins/plugin-profiles/reference/config-locations.md delete mode 100644 plugins/prototype/reference/config-locations.md delete mode 100644 plugins/repo-hygiene/reference/config-locations.md delete mode 100644 plugins/review/reference/config-locations.md delete mode 100644 plugins/session-flow/reference/config-locations.md delete mode 100644 plugins/skill-quality/reference/config-locations.md delete mode 100644 plugins/user-experience/reference/config-locations.md delete mode 100644 plugins/visualization/reference/config-locations.md delete mode 100644 plugins/work-items/reference/config-locations.md diff --git a/.changes/adhd/docs-config-locations-10534342.md b/.changes/adhd/docs-config-locations-10534342.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/adhd/docs-config-locations-10534342.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/ai-briefing/docs-config-locations-a8e694e1.md b/.changes/ai-briefing/docs-config-locations-a8e694e1.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/ai-briefing/docs-config-locations-a8e694e1.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/ai-slop/docs-config-locations-9a460e7b.md b/.changes/ai-slop/docs-config-locations-9a460e7b.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/ai-slop/docs-config-locations-9a460e7b.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/architecture/docs-config-locations-e5199209.md b/.changes/architecture/docs-config-locations-e5199209.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/architecture/docs-config-locations-e5199209.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/autonomy/docs-config-locations-44f7a84e.md b/.changes/autonomy/docs-config-locations-44f7a84e.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/autonomy/docs-config-locations-44f7a84e.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/bash-format/docs-config-locations-66a10e61.md b/.changes/bash-format/docs-config-locations-66a10e61.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/bash-format/docs-config-locations-66a10e61.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/code-tidying/docs-config-locations-8c98795d.md b/.changes/code-tidying/docs-config-locations-8c98795d.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/code-tidying/docs-config-locations-8c98795d.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/context-budget/docs-config-locations-a26656d1.md b/.changes/context-budget/docs-config-locations-a26656d1.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/context-budget/docs-config-locations-a26656d1.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/context-usage/docs-config-locations-e943110a.md b/.changes/context-usage/docs-config-locations-e943110a.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/context-usage/docs-config-locations-e943110a.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/debugging/docs-config-locations-98a10919.md b/.changes/debugging/docs-config-locations-98a10919.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/debugging/docs-config-locations-98a10919.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/desktop-notification/docs-config-locations-b434a16e.md b/.changes/desktop-notification/docs-config-locations-b434a16e.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/desktop-notification/docs-config-locations-b434a16e.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/developer-experience/docs-config-locations-9f24c799.md b/.changes/developer-experience/docs-config-locations-9f24c799.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/developer-experience/docs-config-locations-9f24c799.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/discipline/docs-config-locations-9995658b.md b/.changes/discipline/docs-config-locations-9995658b.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/discipline/docs-config-locations-9995658b.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/docs-hygiene/docs-config-locations-47828876.md b/.changes/docs-hygiene/docs-config-locations-47828876.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/docs-hygiene/docs-config-locations-47828876.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/dometrain/docs-config-locations-306a4e1d.md b/.changes/dometrain/docs-config-locations-306a4e1d.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/dometrain/docs-config-locations-306a4e1d.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/education/docs-config-locations-f658770a.md b/.changes/education/docs-config-locations-f658770a.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/education/docs-config-locations-f658770a.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/eol-normalizer/docs-config-locations-9397920f.md b/.changes/eol-normalizer/docs-config-locations-9397920f.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/eol-normalizer/docs-config-locations-9397920f.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/fleet/docs-config-locations-95087e01.md b/.changes/fleet/docs-config-locations-95087e01.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/fleet/docs-config-locations-95087e01.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/guardrails/docs-config-locations-c1c046d9.md b/.changes/guardrails/docs-config-locations-c1c046d9.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/guardrails/docs-config-locations-c1c046d9.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/harness-memory/docs-config-locations-e8373e15.md b/.changes/harness-memory/docs-config-locations-e8373e15.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/harness-memory/docs-config-locations-e8373e15.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/harness-ops/docs-config-locations-2869d22d.md b/.changes/harness-ops/docs-config-locations-2869d22d.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/harness-ops/docs-config-locations-2869d22d.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/javascript-format/docs-config-locations-b6289359.md b/.changes/javascript-format/docs-config-locations-b6289359.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/javascript-format/docs-config-locations-b6289359.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/kindle-dedrm/docs-config-locations-6e40087b.md b/.changes/kindle-dedrm/docs-config-locations-6e40087b.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/kindle-dedrm/docs-config-locations-6e40087b.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/machine-health/docs-config-locations-23f09539.md b/.changes/machine-health/docs-config-locations-23f09539.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/machine-health/docs-config-locations-23f09539.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/miro/docs-config-locations-4f670824.md b/.changes/miro/docs-config-locations-4f670824.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/miro/docs-config-locations-4f670824.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/multi-agent/docs-config-locations-5d9b0546.md b/.changes/multi-agent/docs-config-locations-5d9b0546.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/multi-agent/docs-config-locations-5d9b0546.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/performance/docs-config-locations-40d672b5.md b/.changes/performance/docs-config-locations-40d672b5.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/performance/docs-config-locations-40d672b5.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/planning/docs-config-locations-4954f57b.md b/.changes/planning/docs-config-locations-4954f57b.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/planning/docs-config-locations-4954f57b.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/playbooks/docs-config-locations-9208470f.md b/.changes/playbooks/docs-config-locations-9208470f.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/playbooks/docs-config-locations-9208470f.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/playwright/docs-config-locations-6441774a.md b/.changes/playwright/docs-config-locations-6441774a.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/playwright/docs-config-locations-6441774a.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/plugin-profiles/docs-config-locations-c5e37034.md b/.changes/plugin-profiles/docs-config-locations-c5e37034.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/plugin-profiles/docs-config-locations-c5e37034.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/prototype/docs-config-locations-24e64470.md b/.changes/prototype/docs-config-locations-24e64470.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/prototype/docs-config-locations-24e64470.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/repo-hygiene/docs-config-locations-51682f29.md b/.changes/repo-hygiene/docs-config-locations-51682f29.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/repo-hygiene/docs-config-locations-51682f29.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/review/docs-config-locations-0c394252.md b/.changes/review/docs-config-locations-0c394252.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/review/docs-config-locations-0c394252.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/session-flow/docs-config-locations-31a0c9e7.md b/.changes/session-flow/docs-config-locations-31a0c9e7.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/session-flow/docs-config-locations-31a0c9e7.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/skill-quality/docs-config-locations-a0a6a1c5.md b/.changes/skill-quality/docs-config-locations-a0a6a1c5.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/skill-quality/docs-config-locations-a0a6a1c5.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/user-experience/docs-config-locations-2f4a2460.md b/.changes/user-experience/docs-config-locations-2f4a2460.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/user-experience/docs-config-locations-2f4a2460.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/visualization/docs-config-locations-5507d073.md b/.changes/visualization/docs-config-locations-5507d073.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/visualization/docs-config-locations-5507d073.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/work-items/docs-config-locations-1789468b.md b/.changes/work-items/docs-config-locations-1789468b.md deleted file mode 100644 index 04248064d57..00000000000 --- a/.changes/work-items/docs-config-locations-1789468b.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -bump: patch ---- - -### Changed - -- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/plugins/adhd/reference/config-locations.md b/plugins/adhd/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/adhd/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/ai-briefing/reference/config-locations.md b/plugins/ai-briefing/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/ai-briefing/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/ai-slop/reference/config-locations.md b/plugins/ai-slop/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/ai-slop/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/architecture/reference/config-locations.md b/plugins/architecture/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/architecture/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/autonomy/reference/config-locations.md b/plugins/autonomy/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/autonomy/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/bash-format/reference/config-locations.md b/plugins/bash-format/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/bash-format/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/code-tidying/reference/config-locations.md b/plugins/code-tidying/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/code-tidying/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/context-budget/reference/config-locations.md b/plugins/context-budget/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/context-budget/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/context-usage/reference/config-locations.md b/plugins/context-usage/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/context-usage/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/debugging/reference/config-locations.md b/plugins/debugging/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/debugging/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/desktop-notification/reference/config-locations.md b/plugins/desktop-notification/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/desktop-notification/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/developer-experience/reference/config-locations.md b/plugins/developer-experience/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/developer-experience/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/discipline/reference/config-locations.md b/plugins/discipline/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/discipline/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/docs-hygiene/reference/config-locations.md b/plugins/docs-hygiene/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/docs-hygiene/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/dometrain/reference/config-locations.md b/plugins/dometrain/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/dometrain/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/education/reference/config-locations.md b/plugins/education/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/education/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/eol-normalizer/reference/config-locations.md b/plugins/eol-normalizer/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/eol-normalizer/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/fleet/reference/config-locations.md b/plugins/fleet/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/fleet/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/guardrails/reference/config-locations.md b/plugins/guardrails/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/guardrails/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/harness-memory/reference/config-locations.md b/plugins/harness-memory/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/harness-memory/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/harness-ops/reference/config-locations.md b/plugins/harness-ops/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/harness-ops/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/javascript-format/reference/config-locations.md b/plugins/javascript-format/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/javascript-format/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/kindle-dedrm/reference/config-locations.md b/plugins/kindle-dedrm/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/kindle-dedrm/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/machine-health/reference/config-locations.md b/plugins/machine-health/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/machine-health/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/miro/reference/config-locations.md b/plugins/miro/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/miro/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/multi-agent/reference/config-locations.md b/plugins/multi-agent/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/multi-agent/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/performance/reference/config-locations.md b/plugins/performance/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/performance/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/planning/reference/config-locations.md b/plugins/planning/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/planning/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/playbooks/reference/config-locations.md b/plugins/playbooks/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/playbooks/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/playwright/reference/config-locations.md b/plugins/playwright/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/playwright/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/plugin-profiles/reference/config-locations.md b/plugins/plugin-profiles/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/plugin-profiles/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/prototype/reference/config-locations.md b/plugins/prototype/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/prototype/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/repo-hygiene/reference/config-locations.md b/plugins/repo-hygiene/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/repo-hygiene/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/review/reference/config-locations.md b/plugins/review/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/review/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/session-flow/reference/config-locations.md b/plugins/session-flow/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/session-flow/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/skill-quality/reference/config-locations.md b/plugins/skill-quality/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/skill-quality/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/user-experience/reference/config-locations.md b/plugins/user-experience/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/user-experience/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/visualization/reference/config-locations.md b/plugins/visualization/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/visualization/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/plugins/work-items/reference/config-locations.md b/plugins/work-items/reference/config-locations.md deleted file mode 100644 index dbba05c5cfb..00000000000 --- a/plugins/work-items/reference/config-locations.md +++ /dev/null @@ -1,47 +0,0 @@ - - -# Where plugin config lives - -The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) -owns the rules; this page points at them. - -## The four layers - -Lowest first, a higher layer refining a lower one key by key -([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): - -1. **Plugin default**: bundled in the plugin. -2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, - across repositories. -3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked - ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). -4. **Personal override**: `/.local.`, gitignored by one - `/**/*.local.*` line - ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). - -`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or -`CLAUDE.md`, default `docs/conventions` -([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). -`` is the plugin's name, or a cross-plugin convention's name. - -## Not a plugin config location - -- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. -- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, - `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. -- **Machine-scope plugin state** under `~/.claude/` is outside it too - ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). - -## A plugin that still reads an old path - -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's -[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) -table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) -section list each one. diff --git a/scripts/cross-plugin-source-registry.txt b/scripts/cross-plugin-source-registry.txt index 050da23e595..218977acfba 100644 --- a/scripts/cross-plugin-source-registry.txt +++ b/scripts/cross-plugin-source-registry.txt @@ -872,3 +872,11 @@ lib/cli-version-check.mjs # Dedicated check: scripts/sync-shared-copies.sh --check. Cluster line for the # duplication audit: the root canonical and the copies. lib/cli-version-check.mjs -> plugins/*/lib/cli-version-check.mjs + +# Dedicated check: scripts/sync-shared-copies.sh --check. Canonical: +# docs/contracts/config-cascade/locations.md. +reference/config-locations.md + +# Dedicated check: scripts/sync-shared-copies.sh --check. Cluster line for the +# duplication audit: the canonical contract and the copies. +docs/contracts/config-cascade/locations.md -> plugins/*/reference/config-locations.md diff --git a/scripts/shared-copies.txt b/scripts/shared-copies.txt index ec1388970c7..6fc68c39328 100644 --- a/scripts/shared-copies.txt +++ b/scripts/shared-copies.txt @@ -1007,57 +1007,18 @@ lib/lane-instance-collision-check.md plugins/work-items/skills/work-loop/referen lib/cli-version-check.mjs plugins/context7/lib/cli-version-check.mjs lib/cli-version-check.mjs plugins/firecrawl/lib/cli-version-check.mjs lib/cli-version-check.mjs plugins/playwright/lib/cli-version-check.mjs -docs/contracts/config-cascade/locations.md plugins/adhd/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/ai-briefing/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/ai-slop/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/architecture/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/attribution/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/autonomy/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/bash-format/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/bugs/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/code-metrics/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/code-tidying/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/codebase-health/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/context-budget/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/context-usage/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/debugging/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/desktop-notification/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/developer-experience/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/discipline/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/discovery/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/disk-hygiene/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/docs-hygiene/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/docs-naming/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/dometrain/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/education/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/eol-normalizer/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/fleet/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/guardrails/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/harness-config/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/harness-memory/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/harness-ops/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/improvement/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/instruction-placement/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/javascript-format/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/kindle-dedrm/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/machine-health/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/miro/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/multi-agent/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/mutation-testing/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/overengineering/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/performance/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/planning/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/playbooks/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/playwright/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/plugin-profiles/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/plugin-quality/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/prototype/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/repo-hygiene/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/review/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/session-flow/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/skill-quality/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/source-control/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/testing/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/user-experience/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/visualization/reference/config-locations.md -docs/contracts/config-cascade/locations.md plugins/work-items/reference/config-locations.md From 73409d12a401682ecdf8200921e785e591dd48f3 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sat, 21 Nov 2026 14:06:58 -0500 Subject: [PATCH 5/8] docs(config-cascade): keep config where each plugin reads it until it migrates The pointer sentence told readers to put new config where config locations says, but the resolvers still read their old paths (for example code-metrics' personal override), so following it silently dropped the setting. Say to keep config where the page says it is read until the plugin migrates, then move it. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015XWwmfSVU9f2by5nqbM3Ak --- docs/contracts/commit-convention/README.md | 2 +- docs/contracts/finding-suppression/README.md | 2 +- docs/contracts/rendered-views/README.md | 2 +- docs/conventions/review-digest.md | 2 +- plugins/attribution/skills/audit/SKILL.md | 2 +- plugins/attribution/skills/setup/SKILL.md | 2 +- plugins/bugs/reference/config.md | 2 +- plugins/bugs/skills/setup/SKILL.md | 2 +- plugins/code-metrics/README.md | 2 +- plugins/code-metrics/reference/config.md | 2 +- plugins/code-metrics/skills/principles/reference/thresholds.md | 2 +- plugins/code-metrics/skills/setup/SKILL.md | 2 +- plugins/codebase-health/README.md | 2 +- plugins/codebase-health/skills/audit/SKILL.md | 2 +- plugins/codebase-health/skills/setup/SKILL.md | 2 +- plugins/discovery/README.md | 2 +- plugins/disk-hygiene/README.md | 2 +- plugins/disk-hygiene/skills/clean/SKILL.md | 2 +- plugins/docs-naming/README.md | 2 +- plugins/docs-naming/reference/config.md | 2 +- plugins/docs-naming/skills/setup/SKILL.md | 2 +- plugins/harness-config/skills/setup/SKILL.md | 2 +- plugins/improvement/README.md | 2 +- plugins/improvement/reference/config.md | 2 +- plugins/improvement/skills/find/context/hotspots.md | 2 +- plugins/improvement/skills/setup/SKILL.md | 2 +- plugins/instruction-placement/reference/consumer-config.md | 2 +- plugins/mutation-testing/skills/audit/context/suppression.md | 2 +- plugins/mutation-testing/skills/setup/SKILL.md | 2 +- plugins/overengineering/reference/consumer-config.md | 2 +- plugins/plugin-quality/reference/config.md | 2 +- plugins/plugin-quality/skills/setup/SKILL.md | 2 +- plugins/source-control/README.md | 2 +- plugins/source-control/reference/config-resolution.md | 2 +- plugins/source-control/skills/commit/SKILL.md | 2 +- plugins/source-control/skills/commit/reference/config-probes.md | 2 +- plugins/source-control/skills/setup/SKILL.md | 2 +- .../source-control/skills/setup/reference/apply-convention.md | 2 +- plugins/testing/README.md | 2 +- plugins/testing/skills/check-visual-parity/SKILL.md | 2 +- plugins/testing/skills/run-e2e/SKILL.md | 2 +- plugins/testing/skills/run-e2e/context/e2e-config.md | 2 +- plugins/testing/skills/setup/SKILL.md | 2 +- plugins/testing/skills/write/SKILL.md | 2 +- 44 files changed, 44 insertions(+), 44 deletions(-) diff --git a/docs/contracts/commit-convention/README.md b/docs/contracts/commit-convention/README.md index d7e33f533a8..4dac331f623 100644 --- a/docs/contracts/commit-convention/README.md +++ b/docs/contracts/commit-convention/README.md @@ -59,7 +59,7 @@ name the file to change. it: an operator who wants `/source-control:commit` to draft to the same pattern also sets `## subject_pattern` in the drafting personal override, `.claude/source-control.local.md`. - A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../config-cascade/locations.md) says. + A plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../config-cascade/locations.md) says. The folder-form file, and its fail-closed checks, are read only for a key the YAML lacks: a broken folder-form file never disables a key the YAML supplies. Each key holds exactly one diff --git a/docs/contracts/finding-suppression/README.md b/docs/contracts/finding-suppression/README.md index a5a13295671..d172a40b9e6 100644 --- a/docs/contracts/finding-suppression/README.md +++ b/docs/contracts/finding-suppression/README.md @@ -33,7 +33,7 @@ The consuming plugin names its own surface. The first adopter, `harness-config`' | 2 | team (tracked) | `/harness-config.yaml` (`` from the convention-home pointer line, default `docs/conventions`) | | 3 | personal override (gitignored) | `.claude/audit-pass.local.md` | -A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../config-cascade/locations.md) says. +A plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../config-cascade/locations.md) says. In a YAML concern file the `suppressions` mapping sits at the root with the entry shape below; a reader that uses the shared YAML-subset parser needs the `"anchor/v1":` key quoted. diff --git a/docs/contracts/rendered-views/README.md b/docs/contracts/rendered-views/README.md index 2c0790352a7..54f786a7c10 100644 --- a/docs/contracts/rendered-views/README.md +++ b/docs/contracts/rendered-views/README.md @@ -928,7 +928,7 @@ lane. A skill runs its `resolve` command and never reads the files itself. chain). Each lane registers once in the medium registry with its view kinds, whether it is hosted-capable, and its default. - A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../config-cascade/locations.md) says. + A plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../config-cascade/locations.md) says. ## Template vendoring posture diff --git a/docs/conventions/review-digest.md b/docs/conventions/review-digest.md index d55d50e7a6f..d97f89dbaae 100644 --- a/docs/conventions/review-digest.md +++ b/docs/conventions/review-digest.md @@ -55,7 +55,7 @@ an earlier one key by key: the layer below. 3. personal override `.claude/review-digest.local.json` - A plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../contracts/config-cascade/locations.md) says. + A plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../contracts/config-cascade/locations.md) says. The result names the layer that supplied each value (`team :`, `user-global `, `personal-override `, or `default`). Quote glob values in the YAML file (`"**/hooks/**"`), diff --git a/plugins/attribution/skills/audit/SKILL.md b/plugins/attribution/skills/audit/SKILL.md index 43d79c200ed..a690d3ff836 100644 --- a/plugins/attribution/skills/audit/SKILL.md +++ b/plugins/attribution/skills/audit/SKILL.md @@ -313,7 +313,7 @@ layer supplying every effective value. The accuracy dials (`nomination_passes`, tunable per repo; the gates bind fix eligibility and release readiness only, and never filter what the report shows. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. When `deep_research_on_exhaustion` is on and a research-capable skill is enabled, a budget-exhausted candidate may escalate to `/discovery:research` (if that plugin is enabled). diff --git a/plugins/attribution/skills/setup/SKILL.md b/plugins/attribution/skills/setup/SKILL.md index ad6efbf71d3..3e2e628041d 100644 --- a/plugins/attribution/skills/setup/SKILL.md +++ b/plugins/attribution/skills/setup/SKILL.md @@ -94,7 +94,7 @@ an earlier one: | 2 | team | `//attribution.yaml` | the repository, tracked | | 3 | personal override | `//attribution.local.yaml` | one operator in one repo, gitignored | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. `apply` writes only the team layer and the personal override, never the user-global file. Before it writes the personal override, `git check-ignore -q "//attribution.local.yaml"` must exit 0; when diff --git a/plugins/bugs/reference/config.md b/plugins/bugs/reference/config.md index d3b8c3718f8..e7dfe7ffdf4 100644 --- a/plugins/bugs/reference/config.md +++ b/plugins/bugs/reference/config.md @@ -18,7 +18,7 @@ Three layers, resolved in this order, where a later layer refines an earlier one | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/docs/conventions/bugs.yaml` for the keys; `${CLAUDE_PROJECT_DIR}/docs/conventions/bugs.md` for prose and `## Gotchas` | must be tracked, the only layer teammates receive | | 3 | personal override | `${CLAUDE_PROJECT_DIR}/.claude/bugs.local.md` | must be gitignored, never staged | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. The team files sit in `docs/conventions/` whatever convention home the repository binds; a repository that binds another home still keeps them there. diff --git a/plugins/bugs/skills/setup/SKILL.md b/plugins/bugs/skills/setup/SKILL.md index a3e29f08339..1650f70172d 100644 --- a/plugins/bugs/skills/setup/SKILL.md +++ b/plugins/bugs/skills/setup/SKILL.md @@ -124,7 +124,7 @@ never written. already covered. 7. **Remind them to stage it.** The team file reaches teammates only once committed. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. Re-running `apply` when everything already matches changes nothing and reports "already configured". diff --git a/plugins/code-metrics/README.md b/plugins/code-metrics/README.md index f91d7bc3d4e..ebb69d447ef 100644 --- a/plugins/code-metrics/README.md +++ b/plugins/code-metrics/README.md @@ -88,7 +88,7 @@ and `enabled`. References ship with their provenance: cyclomatic 20 cites ISO/IE a documented YAML subset (block style, flow sequences of scalars, no flow mappings). Every key: `reference/config.md`; `/code-metrics:setup` writes the team layer and probes the collectors. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. ## The report diff --git a/plugins/code-metrics/reference/config.md b/plugins/code-metrics/reference/config.md index b6703bb0875..c5279620743 100644 --- a/plugins/code-metrics/reference/config.md +++ b/plugins/code-metrics/reference/config.md @@ -17,7 +17,7 @@ resolved in this order over the bundled defaults (`scripts/config-defaults.json` | 2 | team | `/docs/conventions/code-metrics.yaml` | the repository, tracked | | 3 | personal override | `/.claude/code-metrics.local.yaml` | one operator in one repository, gitignored | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. The team layer is `docs/conventions/code-metrics.yaml` alone. The team file earlier releases read from the repository's `.claude/` directory is retired and never read. `/code-metrics:setup check` diff --git a/plugins/code-metrics/skills/principles/reference/thresholds.md b/plugins/code-metrics/skills/principles/reference/thresholds.md index bbf9de59cd3..1fe989252bb 100644 --- a/plugins/code-metrics/skills/principles/reference/thresholds.md +++ b/plugins/code-metrics/skills/principles/reference/thresholds.md @@ -94,7 +94,7 @@ rest of the defaults intact. The full key list is [`reference/config.md`](../../ that supplied any value a personal layer changed, so a number that differs from a teammate's is traceable to the layer that changed it rather than to the code. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../../reference/config-locations.md) says. Setting a reference to `null` is a legitimate choice and turns the count off while the measure keeps reporting. Setting one to a value you can defend for your codebase is a better choice than adopting diff --git a/plugins/code-metrics/skills/setup/SKILL.md b/plugins/code-metrics/skills/setup/SKILL.md index f34e56670b8..23ccfeac7e2 100644 --- a/plugins/code-metrics/skills/setup/SKILL.md +++ b/plugins/code-metrics/skills/setup/SKILL.md @@ -20,7 +20,7 @@ surface and for the external collectors the audits probe: `check` inspects and v persists, and neither installs anything. Keys, defaults, and provenance: `${CLAUDE_PLUGIN_ROOT}/reference/config.md`. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. Action routing: no argument or `check` runs the check; `apply` runs the check first, then persists. `apply` is non-interactive when complete `=` arguments are supplied diff --git a/plugins/codebase-health/README.md b/plugins/codebase-health/README.md index 8c663eca763..0dd7fa1f569 100644 --- a/plugins/codebase-health/README.md +++ b/plugins/codebase-health/README.md @@ -58,7 +58,7 @@ it>)`, and any notice. A `terminal` result drops the offer. The tracked team fil new home; a `terminal` or `file` value in one still keeps the view local when no other setting decides, and a publishing value there is ignored. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. ## Configurable audit dimensions diff --git a/plugins/codebase-health/skills/audit/SKILL.md b/plugins/codebase-health/skills/audit/SKILL.md index ec43d5f9447..02b866afc2c 100644 --- a/plugins/codebase-health/skills/audit/SKILL.md +++ b/plugins/codebase-health/skills/audit/SKILL.md @@ -113,7 +113,7 @@ pass). Come from the consuming repo's tracked config, resolved additively across 2. `.claude/codebase-health.md` (team, tracked) 3. `.claude/codebase-health.local.md` (personal override, gitignored) - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. The four bundled dimensions are `documentation`, `configuration`, `code-quality`, and `architecture`; the config may tune their globs, remove a dimension, or add custom ones. diff --git a/plugins/codebase-health/skills/setup/SKILL.md b/plugins/codebase-health/skills/setup/SKILL.md index 9581cc1fc3d..d179f6a3c51 100644 --- a/plugins/codebase-health/skills/setup/SKILL.md +++ b/plugins/codebase-health/skills/setup/SKILL.md @@ -25,7 +25,7 @@ earlier layer's and example-claims concatenate, **except** that a later layer de with empty source lists is an explicit opt-out that *removes* that inherited dimension. This skill writes only the **team** file; changes to the user-global layer or the personal override are the user's to make. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. ## `check` (read-only) diff --git a/plugins/discovery/README.md b/plugins/discovery/README.md index 1626b01d4c1..9527f781003 100644 --- a/plugins/discovery/README.md +++ b/plugins/discovery/README.md @@ -160,7 +160,7 @@ because a spawn's `model` takes an alias only ([sub-agents: choose a model](https://code.claude.com/docs/en/sub-agents#choose-a-model)). With no such layer, or without `multi-agent`, the pins apply. The rule: `reference/parent-contract.md`, "The worker's model is the parent's call". -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. diff --git a/plugins/disk-hygiene/README.md b/plugins/disk-hygiene/README.md index 81c41747d83..5e82075bd0d 100644 --- a/plugins/disk-hygiene/README.md +++ b/plugins/disk-hygiene/README.md @@ -387,7 +387,7 @@ Without `--policy`, standing policy files layer over the baseline when present: `.claude/disk-hygiene.json`. An explicit `--policy` file is the invocation-specific choice and replaces both standing layers. The scan output records which sources applied. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. Candidate hints can be disabled or extended. Consumer protection globs are additive. A relative glob matches a path relative to the scan target. A glob that starts with `/`, a drive letter, or `\\` (a UNC path such as `\\server\share\keep\**`) matches the absolute path, so a standing overlay can protect a tree no matter which parent is scanned. An object `{glob, reason}` is accepted. For every entry that matches a path, the scan entry, the preview candidate, the handoff-verify verdict, and a skipped apply path list it under `protection_matches`, sorted and deduplicated, as `{glob}` or `{glob, reason}`. That field sits beside the `consumer-protected-path` reason and is absent when no entry matched. Hard safety predicates and the baseline protected-name/root rules are non-overridable by any layer: a policy diff --git a/plugins/disk-hygiene/skills/clean/SKILL.md b/plugins/disk-hygiene/skills/clean/SKILL.md index 6e279a0a0fa..8313ad3194c 100644 --- a/plugins/disk-hygiene/skills/clean/SKILL.md +++ b/plugins/disk-hygiene/skills/clean/SKILL.md @@ -233,7 +233,7 @@ and `elevation`; none can weaken hard guards. The [overlay schema](reference/pol lists every field; version 1 files load unchanged. The scan output names its `policy_sources` and the effective `elevation`. Scan errors and unvisited protected roots are coverage gaps, not clean. A hint's `entry_types` and the snapshot's `empty_directory_paths` are in [scan-flags.md](reference/scan-flags.md#coverage-and-hint-fields). -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. The scan output may also carry an `os_autoclean` advisory when the target overlaps a zone an OS mechanism (Windows Storage Sense, systemd-tmpfiles) should own. Surface its recommendation in the diff --git a/plugins/docs-naming/README.md b/plugins/docs-naming/README.md index 04ec5a3deca..d723c58fbd6 100644 --- a/plugins/docs-naming/README.md +++ b/plugins/docs-naming/README.md @@ -51,7 +51,7 @@ into it. A user-global file still at the retired `docs-hygiene` name (`~/.claude/docs-hygiene.json`) is read, with a warning from the resolver; rename it to retire the warning. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. ## Renames are gated per file diff --git a/plugins/docs-naming/reference/config.md b/plugins/docs-naming/reference/config.md index 43a86adc27e..0f6e4feaa0a 100644 --- a/plugins/docs-naming/reference/config.md +++ b/plugins/docs-naming/reference/config.md @@ -53,7 +53,7 @@ A user-global file absent under `docs-naming.json` but present under the retired stderr warning from `resolve` and a WARN row from `/docs-naming:setup check`. The new name wins when both exist. Rename the file to retire the warning. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. All three absent is a valid state: every key has a bundled default, and the defaults are this marketplace's own values, except `generated`, which is empty. The recommended gitignore line for diff --git a/plugins/docs-naming/skills/setup/SKILL.md b/plugins/docs-naming/skills/setup/SKILL.md index 2de26bcd134..d8301ffe510 100644 --- a/plugins/docs-naming/skills/setup/SKILL.md +++ b/plugins/docs-naming/skills/setup/SKILL.md @@ -85,7 +85,7 @@ no cleanup, since neither file is read; the old-file rows name the next step. Th layer row reports it as WARN with the same remedy: rename it to `docs-naming.json` in the same directory. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. ## `apply` (idempotent) diff --git a/plugins/harness-config/skills/setup/SKILL.md b/plugins/harness-config/skills/setup/SKILL.md index d172fdc3467..c574fda5d3a 100644 --- a/plugins/harness-config/skills/setup/SKILL.md +++ b/plugins/harness-config/skills/setup/SKILL.md @@ -127,7 +127,7 @@ tracked/ignored question has opposite correct answers per layer, so verify each - **personal override** `.claude/audit-pass.local.md`: must be gitignored and never staged. Staged or tracked is a FAIL: a personal deviation can reach team history. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. Parse each present layer and report as malformed any entry missing **any** of its five required keys: `check`, `claim`, `sites`, `reason`, `date`. Checking only `reason` and `date` would pass an diff --git a/plugins/improvement/README.md b/plugins/improvement/README.md index f83f610aa17..923fd8756e7 100644 --- a/plugins/improvement/README.md +++ b/plugins/improvement/README.md @@ -45,7 +45,7 @@ churn analysis or declare Tier 2 MCP telemetry sources, run `/improvement:setup` the team `.claude/improvement.md`, then the gitignored `.claude/improvement.local.md` personal override. The key contract lives in [reference/config.md](reference/config.md). -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. ## Running it as a standing routine diff --git a/plugins/improvement/reference/config.md b/plugins/improvement/reference/config.md index 089dd5c38c4..561357671e5 100644 --- a/plugins/improvement/reference/config.md +++ b/plugins/improvement/reference/config.md @@ -17,7 +17,7 @@ Three layers, resolved in this order, where a later layer refines an earlier one | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/improvement.md` | must be tracked, the only layer teammates receive | | 3 | personal override | `${CLAUDE_PROJECT_DIR}/.claude/improvement.local.md` | must be gitignored, never staged | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. Resolution anchors at the repo root, `${CLAUDE_PROJECT_DIR}` when set and otherwise `git rev-parse --show-toplevel`, never at the CWD. Every layer that exists is read and merged; diff --git a/plugins/improvement/skills/find/context/hotspots.md b/plugins/improvement/skills/find/context/hotspots.md index 4ef892d33d9..8ffe89788f0 100644 --- a/plugins/improvement/skills/find/context/hotspots.md +++ b/plugins/improvement/skills/find/context/hotspots.md @@ -83,7 +83,7 @@ Step 1's `excludes` as one ERE, alternatives joined with `|`, from two sources: The scan asks nothing and writes no record; `/improvement:setup apply` offers to persist them as `churn_exclude` entries. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../../reference/config-locations.md) says. All layers absent is a valid state. When item 2 resolves nothing while `churn_exclude_defaults` is on, record an evidence-gap line (format: unattended.md), e.g. diff --git a/plugins/improvement/skills/setup/SKILL.md b/plugins/improvement/skills/setup/SKILL.md index 74d8b32d7cc..286362416d6 100644 --- a/plugins/improvement/skills/setup/SKILL.md +++ b/plugins/improvement/skills/setup/SKILL.md @@ -34,7 +34,7 @@ skill writes only the **team** file; changes to the user-global layer or the per user's to make. Anchor every repo-relative read at the repo root (`${CLAUDE_PROJECT_DIR}` when set, otherwise `git rev-parse --show-toplevel`), never at the CWD. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. ## `check` (read-only) diff --git a/plugins/instruction-placement/reference/consumer-config.md b/plugins/instruction-placement/reference/consumer-config.md index 8550efa2bd3..e22bddca5d0 100644 --- a/plugins/instruction-placement/reference/consumer-config.md +++ b/plugins/instruction-placement/reference/consumer-config.md @@ -35,7 +35,7 @@ Three layers, resolved in this order: | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/instruction-placement.md` | | 3 | personal override (gitignored) | `${CLAUDE_PROJECT_DIR}/.claude/instruction-placement.local.md` | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. **Merge form: per-key override**, declared here as the cascade convention requires. Entries merge per `finding_id`: a later layer's entry for one id wins for that id only, and every id it does not diff --git a/plugins/mutation-testing/skills/audit/context/suppression.md b/plugins/mutation-testing/skills/audit/context/suppression.md index 1e048584979..87dab032d69 100644 --- a/plugins/mutation-testing/skills/audit/context/suppression.md +++ b/plugins/mutation-testing/skills/audit/context/suppression.md @@ -80,7 +80,7 @@ So `.claude/mutation-testing-arid.local.md` is a **draft** file. Describing it a the config" is wrong in exactly the direction that matters. The config's later layers do take effect, and this record's do not. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../../reference/config-locations.md) says. ## Obligations this skill must meet diff --git a/plugins/mutation-testing/skills/setup/SKILL.md b/plugins/mutation-testing/skills/setup/SKILL.md index d69c07a0eea..e8b98cb12db 100644 --- a/plugins/mutation-testing/skills/setup/SKILL.md +++ b/plugins/mutation-testing/skills/setup/SKILL.md @@ -28,7 +28,7 @@ The config resolves across three layers, lowest first: the user layer (`userConf `${CLAUDE_PLUGIN_ROOT}/schemas/mutation-testing.schema.json`) → personal override (`.claude/mutation-testing.local.md`), later layers overriding scalars and unioning lists. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. The team file of earlier releases, .claude/mutation-testing.md, is retired and never read as a layer. While it exists, `check` probe 6 reports it as INFO, which gates nothing, naming `apply` as the move, or, once diff --git a/plugins/overengineering/reference/consumer-config.md b/plugins/overengineering/reference/consumer-config.md index 0b8223b015e..56982dbce87 100644 --- a/plugins/overengineering/reference/consumer-config.md +++ b/plugins/overengineering/reference/consumer-config.md @@ -31,7 +31,7 @@ Three layers, resolved in this order: | 2 | team (tracked) | `${CLAUDE_PROJECT_DIR}/.claude/overengineering.md` | | 3 | personal override (gitignored) | `${CLAUDE_PROJECT_DIR}/.claude/overengineering.local.md` | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. **Merge form: per-key override**, declared here as the cascade convention requires. The values are scalars and closed mappings, where concatenation is meaningless: a later layer replaces an earlier diff --git a/plugins/plugin-quality/reference/config.md b/plugins/plugin-quality/reference/config.md index 2d15b7c0640..773a25975ed 100644 --- a/plugins/plugin-quality/reference/config.md +++ b/plugins/plugin-quality/reference/config.md @@ -30,7 +30,7 @@ layer and **no personal override channel**; the old layers are retired, each wit | personal override | `.claude/plugin-quality.local.md` | record `plugin-quality-r002` (delete). Never read; setup `check` WARNs while it exists rather than silently ignoring it. | | user-global | `~/.claude/plugin-quality.md` | machine scope, outside the retirement manifest by contract. Never read; setup `check` WARNs in prose when it exists. | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. ## Resolution order diff --git a/plugins/plugin-quality/skills/setup/SKILL.md b/plugins/plugin-quality/skills/setup/SKILL.md index 113e156e823..5befaa1c650 100644 --- a/plugins/plugin-quality/skills/setup/SKILL.md +++ b/plugins/plugin-quality/skills/setup/SKILL.md @@ -79,7 +79,7 @@ against that contract rather than restating it. 6. **Sink reachability**. For the effective sink: `gh-issues` → covered by step 1; `markdown-dir` → the directory exists and is writable; `local-fallback` → nothing to check. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. ## `apply` (writes the pointer region + topic doc, on explicit request) diff --git a/plugins/source-control/README.md b/plugins/source-control/README.md index 01612c53ab3..00a2b970814 100644 --- a/plugins/source-control/README.md +++ b/plugins/source-control/README.md @@ -376,7 +376,7 @@ see [hooks: WorktreeRemove](https://code.claude.com/docs/en/hooks#worktreeremove rules. Defaults (Conventional Commits, squash merge) apply only when the project declares nothing. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. ## Requirements diff --git a/plugins/source-control/reference/config-resolution.md b/plugins/source-control/reference/config-resolution.md index ac71559bc89..fe10e683c94 100644 --- a/plugins/source-control/reference/config-resolution.md +++ b/plugins/source-control/reference/config-resolution.md @@ -744,7 +744,7 @@ Layers, in resolution order, where a later layer refines an earlier one: 3. **`${REPO_ROOT}/.claude/source-control.local.md`**: personal override, gitignored. A per-machine or per-operator deviation from team policy, never committed. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](config-locations.md) says. Each layer is optional, and **fall-through is per key, not per file**. A key absent from every layer is unresolved even when some layer exists: a user-global file contributing only `trailer_policy` diff --git a/plugins/source-control/skills/commit/SKILL.md b/plugins/source-control/skills/commit/SKILL.md index 9d122713c18..1f6909aeaac 100644 --- a/plugins/source-control/skills/commit/SKILL.md +++ b/plugins/source-control/skills/commit/SKILL.md @@ -14,7 +14,7 @@ metadata: Exec-bit backstop: !`bash "${CLAUDE_PLUGIN_ROOT}/skills/commit/scripts/exec-bit-check.sh" --probe 2>/dev/null || echo "unavailable — run the check manually"` Config layer (user-global): !`test -f "$HOME/.claude/source-control.md" && echo present || echo absent` -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. ## Repository context. Gather first diff --git a/plugins/source-control/skills/commit/reference/config-probes.md b/plugins/source-control/skills/commit/reference/config-probes.md index f2914110812..55d83a0116c 100644 --- a/plugins/source-control/skills/commit/reference/config-probes.md +++ b/plugins/source-control/skills/commit/reference/config-probes.md @@ -54,4 +54,4 @@ substitutes the root at all. This matches the root-resolution requirement already states for resolution itself; the probes must not disagree with it. `exec-bit-check.sh` anchors itself the same way. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../../reference/config-locations.md) says. diff --git a/plugins/source-control/skills/setup/SKILL.md b/plugins/source-control/skills/setup/SKILL.md index 3285d68bbf5..5745108e9e4 100644 --- a/plugins/source-control/skills/setup/SKILL.md +++ b/plugins/source-control/skills/setup/SKILL.md @@ -128,7 +128,7 @@ Per-layer verdicts: remediations, so probe them separately. See the two-probe form under `apply`. Absent file is OK once the ignore rule itself is present. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. **FAIL** when the *effective* `subject_pattern` is not machine-checkable. It must be either the literal keyword `Conventional Commits` or an anchored regex (`^…`-style); a plain-language diff --git a/plugins/source-control/skills/setup/reference/apply-convention.md b/plugins/source-control/skills/setup/reference/apply-convention.md index 0d3a1526ed2..de8bb19ea94 100644 --- a/plugins/source-control/skills/setup/reference/apply-convention.md +++ b/plugins/source-control/skills/setup/reference/apply-convention.md @@ -39,7 +39,7 @@ absent, since a convention is a team artifact until someone says otherwise. | `team` (default) | `REPO_ROOT/docs/conventions/source-control.yaml` | the shared, tracked convention | | `local` | `REPO_ROOT/.claude/source-control.local.md` | a personal deviation from team policy here | -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../../reference/config-locations.md) says. The team layer is YAML, validated by `plugins/source-control/schemas/source-control.schema.json` ([config-resolution.md](../../../reference/config-resolution.md), "The config files"). The user diff --git a/plugins/testing/README.md b/plugins/testing/README.md index d7f730630d6..dc9421fa50a 100644 --- a/plugins/testing/README.md +++ b/plugins/testing/README.md @@ -139,7 +139,7 @@ lower it: the lowest valid value wins, a raise is reported as ignored, and an in named and dropped. A testing release without this key stops its test scan on `pixel_tolerance` in `testing.yaml`, so add the map once every member runs this release. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. `verification` (`off | light | standard | strict`, default `light`) and `verification_skills` (per-skill levels; an entry beats `verification`) set whether `/testing:cleanup`'s Cannot-fail-only mode diff --git a/plugins/testing/skills/check-visual-parity/SKILL.md b/plugins/testing/skills/check-visual-parity/SKILL.md index 3ea206ec28e..e0012ff06d4 100644 --- a/plugins/testing/skills/check-visual-parity/SKILL.md +++ b/plugins/testing/skills/check-visual-parity/SKILL.md @@ -92,7 +92,7 @@ The user-global `~/.claude/testing.yaml`, the personal override `.claude/testing (`source=personal-override`) and the plugin option can only lower the team value. The script reports a raise as ignored, and names an invalid layer and drops it. Quote a `reason` that holds a colon followed by a space. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. A tolerance above 0 is used only with its recorded reason; never pass a higher `--tolerance` than this line gives. To keep a known baseline mismatch under tolerance, the team records a diff --git a/plugins/testing/skills/run-e2e/SKILL.md b/plugins/testing/skills/run-e2e/SKILL.md index 036ab97fba6..1d5d578d579 100644 --- a/plugins/testing/skills/run-e2e/SKILL.md +++ b/plugins/testing/skills/run-e2e/SKILL.md @@ -142,7 +142,7 @@ A legacy testing-format map (`.claude/skills/feature-map/SKILL.md`, or the direc not read. Warn that it is present and name `/app-control:map refresh `, which converts it; the run continues. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. ### Entry points diff --git a/plugins/testing/skills/run-e2e/context/e2e-config.md b/plugins/testing/skills/run-e2e/context/e2e-config.md index a665ad26bad..976aeb2a942 100644 --- a/plugins/testing/skills/run-e2e/context/e2e-config.md +++ b/plugins/testing/skills/run-e2e/context/e2e-config.md @@ -13,7 +13,7 @@ visible, who drives, and whether it drives an app already running. The keys live `~/.claude/testing.yaml`, and personal override `.claude/testing.local.yaml`; per user, the plugin `userConfig` options of the same names. `scripts/resolve-config.sh e2e` resolves them. - This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../../reference/config-locations.md) says. + This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../../reference/config-locations.md) says. All five keys govern only this skill's own driving ([own-driving.md](own-driving.md)). When a run goes through `/app-control:drive` (SKILL.md Step 1), the app's control skill, which diff --git a/plugins/testing/skills/setup/SKILL.md b/plugins/testing/skills/setup/SKILL.md index d428687187e..23efb5439c0 100644 --- a/plugins/testing/skills/setup/SKILL.md +++ b/plugins/testing/skills/setup/SKILL.md @@ -28,7 +28,7 @@ with `*` must be single-quoted. `docs/conventions/testing.yaml` also holds `/tes `map_report_order`, `file_findings` and `file_findings_floor`, and `/testing:write`'s `tdd_refactor_step` and `first_test`, which the scan ignores. -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. The keys: diff --git a/plugins/testing/skills/write/SKILL.md b/plugins/testing/skills/write/SKILL.md index ca2af2e048d..29a744e39ce 100644 --- a/plugins/testing/skills/write/SKILL.md +++ b/plugins/testing/skills/write/SKILL.md @@ -59,7 +59,7 @@ and again in the final summary: Settings: tdd_refactor_step=on (default), first_test=user-flow (docs/conventions/testing.yaml) ``` -This plugin still reads, or reports as retired, the `.claude/` paths named here; new config goes where [config locations](../../reference/config-locations.md) says. +This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. [context/write.md](context/write.md) says what each value changes: the Refactor step and its `Refactor checkpoint:` lines, and which test comes first. From 8a47bad560918023791babe35806fd9f9a01453c Mon Sep 17 00:00:00 2001 From: "melodic-automation-lanes[bot]" <337595936+melodic-automation-lanes[bot]@users.noreply.github.com> Date: Sat, 21 Nov 2026 19:11:29 +0000 Subject: [PATCH 6/8] Apply fix-docs on docs/config-locations Lane-Activity: pr-refine/fix-docs --- docs/contracts/commit-convention/README.md | 12 ++++++------ docs/contracts/rendered-views/README.md | 4 ++-- plugins/attribution/README.md | 2 +- plugins/bugs/reference/config.md | 2 +- plugins/code-metrics/reference/config.md | 2 +- plugins/codebase-health/README.md | 2 +- plugins/improvement/README.md | 2 +- plugins/improvement/reference/config.md | 2 +- .../reference/consumer-config.md | 2 +- plugins/plugin-quality/reference/config.md | 2 +- 10 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/contracts/commit-convention/README.md b/docs/contracts/commit-convention/README.md index d7e33f533a8..8d583793499 100644 --- a/docs/contracts/commit-convention/README.md +++ b/docs/contracts/commit-convention/README.md @@ -1,4 +1,4 @@ -# Commit-convention enforcement seam +# Commit-convention enforcement contract Owner doc for the machine-readable **enforcement** read of a consumer's commit-subject / PR-title convention. This concern is consumed by **more than one plugin**: `source-control` @@ -17,12 +17,12 @@ Enforcement reads a key that file lacks from the folder-form file below. Draftin the folder-form file: the model resolves the YAML and the personal markdown layers in [`source-control/reference/config-resolution.md`](../../../plugins/source-control/reference/config-resolution.md). That document owns **drafting** resolution: how `/source-control:commit` and `/source-control:pull-request` -compose a compliant subject/title. This seam owns the **enforcement** resolution: how a +compose a compliant subject/title. This contract owns the **enforcement** resolution: how a zero-dependency hook decides whether an *already-formed* subject/title is allowed. The two reads are deliberately not identical: -| | Drafting (config-resolution.md) | Enforcement (this seam) | +| | Drafting (config-resolution.md) | Enforcement (this contract) | |---|---|---| | Reader | the model | a POSIX sh hook (`[[ =~ ]]` / `grep -E`) | | Layers read | user-global, team, local, per-key merge | **team-tracked**: `docs/conventions/source-control.yaml`, then the folder-form `docs/conventions/source-control/commit-convention.yml`; for `subject_pattern` only, and only where those set none, the git-ignored personal `docs/conventions/source-control.local.yaml`, never merged | @@ -84,7 +84,7 @@ name the file to change. ## The folder-form convention file `docs/conventions/source-control/commit-convention.yml` is a flat-scalar YAML file, the -tool-agnostic file any consumer (this seam's resolver, a commit-msg hook, CI, another agent) reads +tool-agnostic file any consumer (the enforcement resolver, a commit-msg hook, CI, another agent) reads with one sed. It is the path the org standards sync writes. Enforcement reads it only for a key `docs/conventions/source-control.yaml` lacks. @@ -117,7 +117,7 @@ Contract points: - **`dialect:`** (optional, default `posix-ere`) declares the regex dialect for non-enforcement consumers (a JS CI runner, a PCRE hook) so they know what they are reading instead of silently misreading it. Enforcement itself stays POSIX-ERE-only: a declared non-`posix-ere` dialect - disables this seam's enforcement with a diagnostic, exactly like a PCRE-ism in the pattern. + disables enforcement with a diagnostic, exactly like a PCRE-ism in the pattern. - **Fail closed.** A tracked file that is unreadable, carries a key with an empty value, or is a symlink or sits under a symlinked path segment whose physical target leaves the repository root (the target must be a regular file physically under the repo) disables enforcement with a @@ -167,6 +167,6 @@ purposes without it. `scripts/shared-copies.txt`, the commit-msg entry installs both as assets, and a change to either canonical carries a guardrails release so consumers receive it. -Naming coincidence recorded per the seam rules: the convention file is `docs/conventions/source-control.yaml`, named +Naming coincidence recorded per the shared-concern naming rules: the convention file is `docs/conventions/source-control.yaml`, named after the concern (delivery workflow), not the plugin. The plugin-name collision is incidental; the file is not renamed. diff --git a/docs/contracts/rendered-views/README.md b/docs/contracts/rendered-views/README.md index 2c0790352a7..60790e284d1 100644 --- a/docs/contracts/rendered-views/README.md +++ b/docs/contracts/rendered-views/README.md @@ -830,8 +830,8 @@ validation answer set). Fleet audits check those surfaces against this section. copies the state the user built out as text they can paste into the session or commit. For the author's version of this rule, see S2, section "Custom editing interfaces" ([source list](../../finding-your-unknowns.md#sources-and-citation-shape)). The doctrine -recurs three times independently in the corpus; it is what keeps a throwaway editor inside -the agent loop instead of becoming a dead end. +recurs three times independently in the corpus; without the control, the state a user +builds in a throwaway editor stays in the browser, so the session never sees it. **Who is bound.** Skills that emit interactive HTML artifacts cite this section. diff --git a/plugins/attribution/README.md b/plugins/attribution/README.md index 2c924288cdf..64484325d63 100644 --- a/plugins/attribution/README.md +++ b/plugins/attribution/README.md @@ -20,7 +20,7 @@ A copied paragraph starts accurate and silently stops being accurate the next ti page changes. Nothing in the repository records that it drifted. Citing the source and fetching it at read time removes the drift risk entirely; where a surface must act on a volatile specific without the source, a stamped record (the surface's own decision in its own words, a pointer, an -as-of date, a recheck trigger) keeps it honest and re-checkable without copying the source. +as-of date, a recheck trigger) lets a reader tell when to recheck it, without copying the source. ## Skills diff --git a/plugins/bugs/reference/config.md b/plugins/bugs/reference/config.md index d3b8c3718f8..22cb613e56e 100644 --- a/plugins/bugs/reference/config.md +++ b/plugins/bugs/reference/config.md @@ -124,7 +124,7 @@ one entry were absent. Do not discard the whole layer. ## Consumer `.gitignore` -One recursive line covers the personal override here and every other cascade surface: +One recursive line covers the personal override here and every other cascade config file: ```gitignore .claude/**/*.local.* diff --git a/plugins/code-metrics/reference/config.md b/plugins/code-metrics/reference/config.md index b6703bb0875..59283455ee9 100644 --- a/plugins/code-metrics/reference/config.md +++ b/plugins/code-metrics/reference/config.md @@ -1,6 +1,6 @@ # The code-metrics configuration -Every tunable value in this plugin resolves through one consumer surface. This document is its +Every tunable value in this plugin resolves through one set of config layers. This document is their contract: the layers, the merge form, the YAML subset, and every key with its default and provenance. `/code-metrics:setup` writes the team layer; every audit skill reads the resolved document at run time and prints the layer that supplied any value a personal layer changed. The diff --git a/plugins/codebase-health/README.md b/plugins/codebase-health/README.md index 8c663eca763..ca49f40a245 100644 --- a/plugins/codebase-health/README.md +++ b/plugins/codebase-health/README.md @@ -104,7 +104,7 @@ verified non-issue. Nothing project-specific is baked into the plugin. One `userConfig` option, `medium`: your own default for the rendered-view offer (default `auto`), read by the shared medium resolver above. Audit targets flow through the tracked -`.claude/codebase-health.md` config seam above (written by `/codebase-health:setup apply`). No +`.claude/codebase-health.md` config file above (written by `/codebase-health:setup apply`). No hooks, no MCP servers, no bundled scripts beyond the shared `lib/` copies (medium resolver, prerequisites check, verification reader), no network calls of its own (Phase 2 may use whatever documentation-research tools your setup provides). State: the audit reads and writes only the consumer's own files under the scope you give it. diff --git a/plugins/improvement/README.md b/plugins/improvement/README.md index f83f610aa17..0d2999b7cb6 100644 --- a/plugins/improvement/README.md +++ b/plugins/improvement/README.md @@ -53,7 +53,7 @@ This plugin still reads, or reports as retired, the `.claude/` paths named here; run persists a ranked report and files top candidates as work items, with prioritization always human-gated. The recommended wrapper is a **weekly [Routine](https://code.claude.com/docs/en/routines)**. Each firing gets a fresh session, and the -routine's saved prompt is the tuning surface. Consult that docs page for current Routine +routine's saved prompt is where you tune it. Consult that docs page for current Routine capabilities and limits rather than relying on numbers written here. ### Prerequisite: the plugin must be loaded in the fired session diff --git a/plugins/improvement/reference/config.md b/plugins/improvement/reference/config.md index 089dd5c38c4..50a9e4c5049 100644 --- a/plugins/improvement/reference/config.md +++ b/plugins/improvement/reference/config.md @@ -111,7 +111,7 @@ hard error and never a fabricated reading. ## Consumer `.gitignore` -One recursive line covers the personal override here and every other cascade surface: +One recursive line covers the personal override here and every other cascade config file: ```gitignore .claude/**/*.local.* diff --git a/plugins/instruction-placement/reference/consumer-config.md b/plugins/instruction-placement/reference/consumer-config.md index 8550efa2bd3..641aa0b2543 100644 --- a/plugins/instruction-placement/reference/consumer-config.md +++ b/plugins/instruction-placement/reference/consumer-config.md @@ -118,7 +118,7 @@ Three obligations this plugin takes on top of the convention: writes it only on the operator's explicit yes, the same per-item gate that authorizes a move, reused for the decision to stop being asked. A skill that wrote one unprompted would record an acceptance nobody made. `instruction-placement:delta` and `instruction-placement:audit` never write - this surface at all; they only read it. + this file at all; they only read it. - **Visible, never silent.** Every run reports each suppressed finding with its reason, date, and contributing layer, and every entry that did *not* suppress: each `personal-only, not applied` and each malformed one. A scoped run reports what it examined: it evaluates only entries with a site in diff --git a/plugins/plugin-quality/reference/config.md b/plugins/plugin-quality/reference/config.md index 2d15b7c0640..5f12d457823 100644 --- a/plugins/plugin-quality/reference/config.md +++ b/plugins/plugin-quality/reference/config.md @@ -81,7 +81,7 @@ Two keys live outside the topic doc, in `/plugin-quality.yaml`, checked ag | Key | Values | Default | Meaning | |---|---|---|---| -| `verification`, `verification_skills.` | `off`, `light`, `standard`, `strict` | `light` | Whether `/plugin-quality:audit` runs its adversarial re-examination seam. `standard` keeps the `high`-effort gate; `strict` runs it at every effort; `light` and `off` skip it at every effort and label the findings `unverified`. A skill entry beats the plugin value ([verification level](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/verification-level/README.md)). | +| `verification`, `verification_skills.` | `off`, `light`, `standard`, `strict` | `light` | Whether `/plugin-quality:audit` runs its adversarial re-examination step. `standard` keeps the `high`-effort gate; `strict` runs it at every effort; `light` and `off` skip it at every effort and label the findings `unverified`. A skill entry beats the plugin value ([verification level](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/verification-level/README.md)). | ## Sink resolution ladder (step 6 of the audit) From bbbaf55f76f2a15d77af781e78e5dce5d0beb40b Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sat, 21 Nov 2026 14:26:22 -0500 Subject: [PATCH 7/8] docs(config-cascade): match locations.md to the contract and scope each old-path pointer - bugs, improvement config.md: scope the .claude/**/*.local.* line to the plugin's own override and name /**/*.local.* for the rest - locations.md: keep the tracked .claude/ team file as a supported fallback, as the contract does - locations.md: name the canonical file by path so each generated copy reads correctly - discovery README: say the multi-agent plugin reads .claude/multi-agent.local.yaml (#17998), not discovery - run-e2e SKILL.md: name the two old paths and say the control skill path is a Claude Code project skill - testing README, run-e2e SKILL.md: say e2e.md, worst-case.md and the user-global and local layers are still read, then point to config locations Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015XWwmfSVU9f2by5nqbM3Ak --- docs/contracts/config-cascade/locations.md | 18 +++++++++++------- .../attribution/reference/config-locations.md | 18 +++++++++++------- plugins/bugs/reference/config-locations.md | 18 +++++++++++------- plugins/bugs/reference/config.md | 4 +++- .../code-metrics/reference/config-locations.md | 18 +++++++++++------- .../reference/config-locations.md | 18 +++++++++++------- plugins/discovery/README.md | 4 +++- .../discovery/reference/config-locations.md | 18 +++++++++++------- .../disk-hygiene/reference/config-locations.md | 18 +++++++++++------- .../docs-naming/reference/config-locations.md | 18 +++++++++++------- .../reference/config-locations.md | 18 +++++++++++------- .../improvement/reference/config-locations.md | 18 +++++++++++------- plugins/improvement/reference/config.md | 4 +++- .../reference/config-locations.md | 18 +++++++++++------- .../reference/config-locations.md | 18 +++++++++++------- .../reference/config-locations.md | 18 +++++++++++------- .../reference/config-locations.md | 18 +++++++++++------- .../reference/config-locations.md | 18 +++++++++++------- plugins/testing/README.md | 17 +++++++++++------ plugins/testing/reference/config-locations.md | 18 +++++++++++------- plugins/testing/skills/run-e2e/SKILL.md | 9 +++++++-- 21 files changed, 203 insertions(+), 123 deletions(-) diff --git a/docs/contracts/config-cascade/locations.md b/docs/contracts/config-cascade/locations.md index 820585dbab7..e89217f0484 100644 --- a/docs/contracts/config-cascade/locations.md +++ b/docs/contracts/config-cascade/locations.md @@ -1,8 +1,8 @@ # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -27,8 +27,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -36,9 +35,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/attribution/reference/config-locations.md b/plugins/attribution/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/attribution/reference/config-locations.md +++ b/plugins/attribution/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/bugs/reference/config-locations.md b/plugins/bugs/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/bugs/reference/config-locations.md +++ b/plugins/bugs/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/bugs/reference/config.md b/plugins/bugs/reference/config.md index 74622c9a1c9..515f3eb4f1f 100644 --- a/plugins/bugs/reference/config.md +++ b/plugins/bugs/reference/config.md @@ -124,7 +124,9 @@ one entry were absent. Do not discard the whole layer. ## Consumer `.gitignore` -One recursive line covers the personal override here and every other cascade config file: +This recursive line ignores the personal override this plugin reads today, `.claude/bugs.local.md`. +A personal override at `` needs `/**/*.local.*` instead; see +[config locations](config-locations.md). ```gitignore .claude/**/*.local.* diff --git a/plugins/code-metrics/reference/config-locations.md b/plugins/code-metrics/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/code-metrics/reference/config-locations.md +++ b/plugins/code-metrics/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/codebase-health/reference/config-locations.md b/plugins/codebase-health/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/codebase-health/reference/config-locations.md +++ b/plugins/codebase-health/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/discovery/README.md b/plugins/discovery/README.md index 9527f781003..8afccac4960 100644 --- a/plugins/discovery/README.md +++ b/plugins/discovery/README.md @@ -160,7 +160,9 @@ because a spawn's `model` takes an alias only ([sub-agents: choose a model](https://code.claude.com/docs/en/sub-agents#choose-a-model)). With no such layer, or without `multi-agent`, the pins apply. The rule: `reference/parent-contract.md`, "The worker's model is the parent's call". -This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](reference/config-locations.md) says. +The multi-agent plugin still reads `.claude/multi-agent.local.yaml` until it migrates +([#17998](https://github.com/melodic-software/claude-code-plugins/issues/17998)); then the file +moves where [config locations](reference/config-locations.md) says. diff --git a/plugins/discovery/reference/config-locations.md b/plugins/discovery/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/discovery/reference/config-locations.md +++ b/plugins/discovery/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/disk-hygiene/reference/config-locations.md b/plugins/disk-hygiene/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/disk-hygiene/reference/config-locations.md +++ b/plugins/disk-hygiene/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/docs-naming/reference/config-locations.md b/plugins/docs-naming/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/docs-naming/reference/config-locations.md +++ b/plugins/docs-naming/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/harness-config/reference/config-locations.md b/plugins/harness-config/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/harness-config/reference/config-locations.md +++ b/plugins/harness-config/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/improvement/reference/config-locations.md b/plugins/improvement/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/improvement/reference/config-locations.md +++ b/plugins/improvement/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/improvement/reference/config.md b/plugins/improvement/reference/config.md index 0fd8dd211cc..aa1290b82f3 100644 --- a/plugins/improvement/reference/config.md +++ b/plugins/improvement/reference/config.md @@ -111,7 +111,9 @@ hard error and never a fabricated reading. ## Consumer `.gitignore` -One recursive line covers the personal override here and every other cascade config file: +This recursive line ignores the personal override this plugin reads today, +`.claude/improvement.local.md`. A personal override at `` needs `/**/*.local.*` +instead; see [config locations](config-locations.md). ```gitignore .claude/**/*.local.* diff --git a/plugins/instruction-placement/reference/config-locations.md b/plugins/instruction-placement/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/instruction-placement/reference/config-locations.md +++ b/plugins/instruction-placement/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/mutation-testing/reference/config-locations.md b/plugins/mutation-testing/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/mutation-testing/reference/config-locations.md +++ b/plugins/mutation-testing/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/overengineering/reference/config-locations.md b/plugins/overengineering/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/overengineering/reference/config-locations.md +++ b/plugins/overengineering/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/plugin-quality/reference/config-locations.md b/plugins/plugin-quality/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/plugin-quality/reference/config-locations.md +++ b/plugins/plugin-quality/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/source-control/reference/config-locations.md b/plugins/source-control/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/source-control/reference/config-locations.md +++ b/plugins/source-control/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/testing/README.md b/plugins/testing/README.md index dc9421fa50a..710b0f7e9f2 100644 --- a/plugins/testing/README.md +++ b/plugins/testing/README.md @@ -98,7 +98,9 @@ installed and enabled, and otherwise reports `judge pass not run: testing plugin not installed or not enabled`. The calibration cases and raters are in `skills/audit/evals/judge-calibration/`. `/testing:run-e2e` reads these optional keys only when it drives the app itself; a run through `/app-control:drive` takes its tools from the control skill. `recording` (`video | gif | off`, default `off`) and -`browser_mode` (`headed | headless`, default `headless`) live on `.claude/testing/e2e.md`. +`browser_mode` (`headed | headless`, default `headless`) live on `.claude/testing/e2e.md`, which +this plugin reads until it migrates; then the file moves where +[config locations](reference/config-locations.md) says. `e2e_driver` (`auto | harness | run | playwright | chrome`) and `reuse_running_instance` (`auto | true | false`), both default `auto`, live in `docs/conventions/testing.yaml`, its personal layers, or the `userConfig` options below; `scripts/resolve-config.sh e2e` resolves them and names @@ -168,7 +170,8 @@ machine that runs this release. Its `worst-case` action also reads an optional `.claude/testing/worst-case.md`, after the bundled catalog in `run-e2e/context/worst-case.md`: the project's own worst-case values, field limits and -data formats, read as data. The action renders a target with that data, reverts what it injected +data formats, read as data. It reads that path until the plugin migrates; then the file moves where +[config locations](reference/config-locations.md) says. The action renders a target with that data, reverts what it injected (proven with `cmp` snapshots), and reports what breaks without editing component code. `/testing:audit` and the `test-weaken` hook read the testing config through the same cascade @@ -181,8 +184,8 @@ The team layer is `docs/conventions/testing.yaml`, validated by takes, plus the two run-e2e keys above. Without it, the team layer is the `yaml config` block in `docs/conventions/testing.md` (read for one more release), else `/.claude/testing.yaml`. The first of the three present wins, and the resolver prints one warning for each other one present. -The prose testing rules stay in `docs/conventions/testing.md`. The user-global and -`.claude/testing.local.yaml` layers do not change. +The prose testing rules stay in `docs/conventions/testing.md`. This release still reads the +user-global and `.claude/testing.local.yaml` layers at those paths. #### Move the team layer to `docs/conventions/testing.yaml` @@ -193,8 +196,10 @@ The prose testing rules stay in `docs/conventions/testing.md`. The user-global a 3. Once every member runs this release, delete the old block or file. Until then every run prints a warning naming both; an older release keeps reading the old one. -`~/.claude/testing.yaml` and `.claude/testing.local.yaml` stay where they are; only the team layer -moves. Reading the block costs the same as reading the file; the measured p50 and p95 are in the +This release moves only the team layer. It still reads `~/.claude/testing.yaml` and +`.claude/testing.local.yaml`; keep them there until the plugin migrates +([#17999](https://github.com/melodic-software/claude-code-plugins/issues/17999)), then move them +where [config locations](reference/config-locations.md) says. Reading the block costs the same as reading the file; the measured p50 and p95 are in the [latency probes](https://github.com/melodic-software/claude-code-plugins/blob/927a5305d238874ce006eaad6b3fa5c3cb07ebc1/docs/specs/tautological-tests/probes.md#team-layer-location-docs-block-or-claudetestingyaml-wsl2), and `plugins/testing/scripts/time-config.sh` reproduces them. diff --git a/plugins/testing/reference/config-locations.md b/plugins/testing/reference/config-locations.md index dbba05c5cfb..0d0e2a16653 100644 --- a/plugins/testing/reference/config-locations.md +++ b/plugins/testing/reference/config-locations.md @@ -4,8 +4,8 @@ edit the canonical source, then rerun the script. --> # Where plugin config lives The one editable list of config file locations for this marketplace's plugins. Each plugin that -teaches a location carries a generated copy at `reference/config-locations.md`; edit this file, -never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) owns the rules; this page points at them. ## The four layers @@ -30,8 +30,7 @@ Lowest first, a higher layer refining a lower one key by key ## Not a plugin config location - **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. -- **No `.claude/` file for plugin config.** Team and personal files live at ``, never - `.claude/` or `.claude/.local.`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. - **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. - **Machine-scope plugin state** under `~/.claude/` is outside it too @@ -39,9 +38,14 @@ Lowest first, a higher layer refining a lower one key by key ## A plugin that still reads an old path -Some plugins still read `~/.claude/` or `.claude/.local.` until each migrates in -its own change. Those reads are declared deviations, not locations to copy. A plugin's own docs -name what it reads today; the contract's +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's [Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) section list each one. diff --git a/plugins/testing/skills/run-e2e/SKILL.md b/plugins/testing/skills/run-e2e/SKILL.md index 1d5d578d579..a1099504748 100644 --- a/plugins/testing/skills/run-e2e/SKILL.md +++ b/plugins/testing/skills/run-e2e/SKILL.md @@ -142,7 +142,10 @@ A legacy testing-format map (`.claude/skills/feature-map/SKILL.md`, or the direc not read. Warn that it is present and name `/app-control:map refresh `, which converts it; the run continues. -This plugin still reads, or reports as retired, the `.claude/` paths named here; until the plugin migrates, keep config where this page says it is read, then move it where [config locations](../../reference/config-locations.md) says. +This plugin still reads `.claude/testing.local.yaml` and reports `.claude/skills/feature-map/SKILL.md` +as retired; until the plugin migrates, keep config where this page says it is read, then move it +where [config locations](../../reference/config-locations.md) says. The control skill's +`.claude/skills/control-/` is a Claude Code project skill, not plugin config. ### Entry points @@ -350,7 +353,9 @@ zoom, dark and right-to-left environments, and report. Before injecting a file a it, save `git diff HEAD` and `git status --porcelain --untracked-files=all --ignored` outside the tree and compare each pair with `cmp`; a difference ends the run degraded. Outside a git checkout, or with no mockable boundary, nothing is injected and every finding is labeled inferred. The -consumer file `.claude/testing/worst-case.md` extends the catalog and is read as data. The action +consumer file `.claude/testing/worst-case.md` extends the catalog and is read as data; this plugin +reads it there until it migrates, then it moves where +[config locations](../../reference/config-locations.md) says. The action edits no component code; fixes go to the user. It always takes own driving and skips Step 1: `/app-control:drive` injects no data. From 08a02aa100dc1e07b40826cf927f9d57b5f7aa90 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Sat, 21 Nov 2026 15:16:27 -0500 Subject: [PATCH 8/8] docs(config-cascade): point multi-agent and ai-slop old-path docs at config locations - multi-agent README, reference/config.md, setup SKILL.md: say the plugin still reads ~/.claude/multi-agent.yaml and .claude/multi-agent.local.yaml (#17998), then point to config locations - ai-slop audit SKILL.md: say the plugin still reads $HOME/.claude/ai-slop.json (#18004), then point to config locations - add the generated reference/config-locations.md copy, its shared-copies line and a changelog fragment to both plugins Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_015XWwmfSVU9f2by5nqbM3Ak --- .../ai-slop/docs-config-locations-68a16396.md | 7 +++ .../docs-config-locations-74199461.md | 7 +++ plugins/ai-slop/reference/config-locations.md | 51 +++++++++++++++++++ plugins/ai-slop/skills/audit/SKILL.md | 4 +- plugins/multi-agent/README.md | 4 ++ .../multi-agent/reference/config-locations.md | 51 +++++++++++++++++++ plugins/multi-agent/reference/config.md | 4 ++ plugins/multi-agent/skills/setup/SKILL.md | 4 ++ scripts/shared-copies.txt | 2 + 9 files changed, 133 insertions(+), 1 deletion(-) create mode 100644 .changes/ai-slop/docs-config-locations-68a16396.md create mode 100644 .changes/multi-agent/docs-config-locations-74199461.md create mode 100644 plugins/ai-slop/reference/config-locations.md create mode 100644 plugins/multi-agent/reference/config-locations.md diff --git a/.changes/ai-slop/docs-config-locations-68a16396.md b/.changes/ai-slop/docs-config-locations-68a16396.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/ai-slop/docs-config-locations-68a16396.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/.changes/multi-agent/docs-config-locations-74199461.md b/.changes/multi-agent/docs-config-locations-74199461.md new file mode 100644 index 00000000000..04248064d57 --- /dev/null +++ b/.changes/multi-agent/docs-config-locations-74199461.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Changed + +- Carries a generated copy of the config-cascade contract's config locations page at `reference/config-locations.md`, the one list of where plugin config lives. diff --git a/plugins/ai-slop/reference/config-locations.md b/plugins/ai-slop/reference/config-locations.md new file mode 100644 index 00000000000..0d0e2a16653 --- /dev/null +++ b/plugins/ai-slop/reference/config-locations.md @@ -0,0 +1,51 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/ai-slop/skills/audit/SKILL.md b/plugins/ai-slop/skills/audit/SKILL.md index 341d91f2a5d..157be2f50c8 100644 --- a/plugins/ai-slop/skills/audit/SKILL.md +++ b/plugins/ai-slop/skills/audit/SKILL.md @@ -214,7 +214,9 @@ the fix flow, under [Non-repository targets](#non-repository-targets). - `plugins/` is not in scope; plugin content is audited in its own repository. - The detector's user config layer is the JSON file `$HOME/.claude/ai-slop.json`, even when `CLAUDE_CONFIG_DIR` is set; the team and personal layers are YAML. Its project layers come from - the session's project directory. + the session's project directory. The plugin still reads that JSON file until it migrates + ([#18004](https://github.com/melodic-software/claude-code-plugins/issues/18004)); then it moves + where [config locations](../../reference/config-locations.md) says. - A path target such as `~/.claude` covers every `*.md` beneath it. ### Non-repository targets diff --git a/plugins/multi-agent/README.md b/plugins/multi-agent/README.md index 7b856721847..9b527f5792c 100644 --- a/plugins/multi-agent/README.md +++ b/plugins/multi-agent/README.md @@ -130,6 +130,10 @@ One configuration, layered user-global (`~/.claude/multi-agent.yaml`), team key. `/multi-agent:setup` writes any of the three. Keys, values and layering: [`reference/config.md`](reference/config.md). +This plugin still reads `~/.claude/multi-agent.yaml` and `.claude/multi-agent.local.yaml` until it +migrates ([#17998](https://github.com/melodic-software/claude-code-plugins/issues/17998)); then the +files move where [config locations](reference/config-locations.md) says. + ## Requirements - **Bash 3.2 or later, awk and git.** The resolver parses the YAML subset with awk, so no diff --git a/plugins/multi-agent/reference/config-locations.md b/plugins/multi-agent/reference/config-locations.md new file mode 100644 index 00000000000..0d0e2a16653 --- /dev/null +++ b/plugins/multi-agent/reference/config-locations.md @@ -0,0 +1,51 @@ + + +# Where plugin config lives + +The one editable list of config file locations for this marketplace's plugins. Each plugin that +teaches a location carries a generated copy at `reference/config-locations.md`; edit +`docs/contracts/config-cascade/locations.md` in claude-code-plugins, never a copy. The [config-cascade contract](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md) +owns the rules; this page points at them. + +## The four layers + +Lowest first, a higher layer refining a lower one key by key +([The layers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#the-layers)): + +1. **Plugin default**: bundled in the plugin. +2. **`userConfig`**: the plugin's option in Claude Code user or managed settings, per person, + across repositories. +3. **Team**: `/.yaml` for keyed values, `/.md` for prose, tracked + ([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). +4. **Personal override**: `/.local.`, gitignored by one + `/**/*.local.*` line + ([Personal override naming](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#personal-override-naming-and-the-consumer-gitignore)). + +`` is the repository's convention home, bound by the pointer region in `AGENTS.md` or +`CLAUDE.md`, default `docs/conventions` +([Expression doctrine](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). +`` is the plugin's name, or a cross-plugin convention's name. + +## Not a plugin config location + +- **No user-global file.** A per-person value goes in `userConfig`, never `~/.claude/`. +- **No new `.claude/` file for plugin config.** Write new team and personal files at ``. +- **Claude Code's own files are outside this contract**: `~/.claude/settings.json`, + `.claude/settings.json`, `.claude/settings.local.json`, `CLAUDE.md`, `CLAUDE.local.md`. +- **Machine-scope plugin state** under `~/.claude/` is outside it too + ([Scope](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#expression-doctrine-which-surfaces-are-files-and-which-are-convention-docs)). + +## A plugin that still reads an old path + +Some plugins still read `~/.claude/` or `.claude/.local.`. Those reads keep +working until each plugin migrates in its own change; they are not locations to copy. + +A tracked `.claude/` team file is still a supported team-layer location, read only when no +`` file supplies the layer +([Location of the team layer](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#location-of-the-team-layer-a-docs-convention-file-or-claudename)). + +A plugin's own docs name what it reads today; the contract's +[Implementers](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#implementers) +table and [Deviations](https://github.com/melodic-software/claude-code-plugins/blob/main/docs/contracts/config-cascade/README.md#deviations) +section list each one. diff --git a/plugins/multi-agent/reference/config.md b/plugins/multi-agent/reference/config.md index ec63b234a9e..e684b0bb58d 100644 --- a/plugins/multi-agent/reference/config.md +++ b/plugins/multi-agent/reference/config.md @@ -15,6 +15,10 @@ this page owns the keys. | Team | `/multi-agent.yaml`, `` being the convention home the repository binds, else `docs/conventions` | | Personal override | `.claude/multi-agent.local.yaml` (gitignored) | +The resolver still reads the user-global and personal override paths above until it migrates +([#17998](https://github.com/melodic-software/claude-code-plugins/issues/17998)); then the files +move where [config locations](config-locations.md) says. + Later layers win per key. Team and personal override are read only when the root is a repository that is neither `$HOME` nor an ancestor of it (`lib/config-root.sh`). The team file is validated by diff --git a/plugins/multi-agent/skills/setup/SKILL.md b/plugins/multi-agent/skills/setup/SKILL.md index 9e1ad618ae1..2c32cde9004 100644 --- a/plugins/multi-agent/skills/setup/SKILL.md +++ b/plugins/multi-agent/skills/setup/SKILL.md @@ -17,6 +17,10 @@ bundled defaults apply. Keys, values, layer paths and the fan-out guard are defined in [`${CLAUDE_PLUGIN_ROOT}/reference/config.md`](${CLAUDE_PLUGIN_ROOT}/reference/config.md). +This plugin still reads `~/.claude/multi-agent.yaml` and `.claude/multi-agent.local.yaml` until it +migrates ([#17998](https://github.com/melodic-software/claude-code-plugins/issues/17998)); then the +files move where [config locations](../../reference/config-locations.md) says. + No argument means `check`. It installs nothing; the resolver needs only Bash, awk and git. diff --git a/scripts/shared-copies.txt b/scripts/shared-copies.txt index 6fc68c39328..a57b35bc657 100644 --- a/scripts/shared-copies.txt +++ b/scripts/shared-copies.txt @@ -1007,6 +1007,7 @@ lib/lane-instance-collision-check.md plugins/work-items/skills/work-loop/referen lib/cli-version-check.mjs plugins/context7/lib/cli-version-check.mjs lib/cli-version-check.mjs plugins/firecrawl/lib/cli-version-check.mjs lib/cli-version-check.mjs plugins/playwright/lib/cli-version-check.mjs +docs/contracts/config-cascade/locations.md plugins/ai-slop/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/attribution/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/bugs/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/code-metrics/reference/config-locations.md @@ -1017,6 +1018,7 @@ docs/contracts/config-cascade/locations.md plugins/docs-naming/reference/config- docs/contracts/config-cascade/locations.md plugins/harness-config/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/improvement/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/instruction-placement/reference/config-locations.md +docs/contracts/config-cascade/locations.md plugins/multi-agent/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/mutation-testing/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/overengineering/reference/config-locations.md docs/contracts/config-cascade/locations.md plugins/plugin-quality/reference/config-locations.md