Skip to content

docs(core): point generated Claude notes at skills, not path-glob rules - #19

Merged
TimCrooker merged 1 commit into
mainfrom
context-slices-over-rules
Aug 12, 2026
Merged

docs(core): point generated Claude notes at skills, not path-glob rules#19
TimCrooker merged 1 commit into
mainfrom
context-slices-over-rules

Conversation

@TimCrooker

@TimCrooker TimCrooker commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Every generated CLAUDE.md currently tells the consuming repo:

Reserve .claude/rules/*.md for narrow path-glob injections only.

The pattern that holds up better is a skill carrying the procedure or standard, plus a scoped CLAUDE.md that points at it — the slice auto-loads in the directories where the work happens, and the depth lives in the skill rather than being injected wholesale on every file touch. The generated note now says that.

Also drops "rule file" from the module-target error in config.ts. It steered readers toward rules while explaining an unrelated config mistake (a module declaring a non-root target).

Rules remain fully supported — claudeRulesDir, claudeRuleFile, and claudePaths are untouched. This only changes what the kit recommends in generated output.

examples/listforge-like regenerated with the CLI. examples/gauntlet was hand-edited on the same line because that fixture currently fails to build for an unrelated reason (010-overview.md declares target api, and modules only compose into the root output) — worth a separate fix.

223 tests pass. Pre-existing prettier warnings on the touched files are left as they were rather than reformatting 114 files in this PR.

Note

Update generated Claude notes to reference .ai/skills/* instead of path-glob rules

  • Updates the guidance bullet in render.ts so generated CLAUDE.md files now direct users to put procedures in .ai/skills/* and reference them from a scoped CLAUDE.md, replacing the old advice to use .claude/rules/*.md for path-glob injections.
  • Updates the same bullet in the example gauntlet/CLAUDE.md and listforge-like/CLAUDE.md to match.
  • Adjusts the error message in config.ts when a module targets a non-root scope to say "its own file" instead of "a rule file".

Macroscope summarized d508947.

The generated CLAUDE.md told every consumer to reserve .claude/rules/*.md for
path-glob injections. The pattern that actually holds up is a skill carrying
the procedure plus a scoped CLAUDE.md pointing at it, which loads where the
work happens.

Also drops 'rule file' from the module-target error, which steered readers to
the same mechanism while explaining an unrelated mistake.
@macroscopeapp

macroscopeapp Bot commented Aug 12, 2026

Copy link
Copy Markdown

Approvability

Verdict: Approved d508947

Documentation-only changes updating guidance text in generated files and one error message string. No runtime behavior or logic changes.

You can customize Macroscope's approvability policy. Learn more.

@TimCrooker
TimCrooker merged commit dc051e3 into main Aug 12, 2026
7 checks passed
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