Skip to content

claude-md: nested-CLAUDE.md vs path-scoped rule as distinct destinations (0.14.0)#7

Merged
illinigirl merged 1 commit into
mainfrom
audit-rule-destination
Jun 22, 2026
Merged

claude-md: nested-CLAUDE.md vs path-scoped rule as distinct destinations (0.14.0)#7
illinigirl merged 1 commit into
mainfrom
audit-rule-destination

Conversation

@illinigirl

Copy link
Copy Markdown
Owner

Area-specific guidance was lumped under "move to a nested CLAUDE.md (.claude/rules in parens)". But nested CLAUDE.md and path-scoped rules scope on different axes, so this makes the audit/curator treat them as a real fork.

The criterion

  • Directory-bound → nested CLAUDE.md — one subtree owns it (web SSR conventions, the poller's test stub).
  • File-type / cross-cutting → .claude/rules/ with paths: — follows a glob across directories, no single dir owns it (all *.test.* must be able to fail; every **/dynamodb.ts paginates its scans).
  • Deciding question: does one directory own this, or does it follow a file type wherever it lives? If you'd copy the same note into three subtrees, it's a rule.

Changes

  • curator hook KIND axis + docstring sharpened to the nested-vs-rule distinction.
  • /claude-md-audit: move-to-nested-CLAUDE.md and move-to-path-scoped-rule are now two distinct triage destinations with the criterion + examples; routing rule-of-thumb and apply step updated.
  • Test asserts the prevention nudge surfaces the rule option; version → 0.14.0.

Verification

claude-md-curator 18/18; all 6 hook suites green; ruff clean; manifests valid; claude plugin validate passes.

🤖 Generated with Claude Code

…ations (0.14.0)

Area-specific guidance was lumped under "nested CLAUDE.md (.claude/rules in
parens)". But they scope on different axes — make it a real fork:
- directory-bound (one dir owns it) -> nested CLAUDE.md
- file-type / cross-cutting (follows a glob across dirs) -> .claude/rules paths:
Deciding question: "does one directory own this, or does it follow a file type
wherever it lives? — if you'd copy it into three subtrees, it's a rule."

- curator hook KIND axis + docstring sharpened to the nested-vs-rule fork.
- /claude-md-audit: two distinct triage destinations (nest vs rule) with the
  criterion + examples (all *.test.* ; every **/dynamodb.ts paginates), routing
  rule of thumb and apply step updated.
- Test asserts the nudge surfaces the rule option; version -> 0.14.0; README.

Verified: claude-md-curator 18/18; all 6 hook suites green; ruff clean;
manifests valid; claude plugin validate passes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D6pwpBdoug4tJRxxVrNNeL
@illinigirl illinigirl merged commit c871c34 into main Jun 22, 2026
6 checks passed
@illinigirl illinigirl deleted the audit-rule-destination branch June 22, 2026 17:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant