Skip to content

Split pattern examples into PATTERNS.md; trim description - #191

Open
dsc-pliancy wants to merge 1 commit into
blader:mainfrom
dsc-pliancy:progressive-disclosure-patterns
Open

Split pattern examples into PATTERNS.md; trim description#191
dsc-pliancy wants to merge 1 commit into
blader:mainfrom
dsc-pliancy:progressive-disclosure-patterns

Conversation

@dsc-pliancy

Copy link
Copy Markdown

What

  • SKILL.md keeps watch-words and problem statements for all 33 patterns, with a pointer to the matching example, instead of full before/after blocks inline. Drops from 412 to 247 lines; no pattern content, numbering, or behavior changes.
  • New PATTERNS.md holds the full before/after examples, keeping SKILL.md lean so a normal invocation doesn't load all 33 of them.
  • Frontmatter description trimmed: drops the Wikipedia-attribution line (already in Reference) and the itemized 10-pattern list, without broadening automatic invocation.

Why

SKILL.md is model-invoked, so its full contents load into context on every relevant turn. The 33 patterns' before/after examples made up the bulk of that (roughly 300 of 412 lines) but are only needed for calibration, not detection, the condensed watch-words and problem statement are enough to spot a pattern; the example is useful on demand, not every time. Splitting them out cuts what loads by default without touching what the skill actually does.

The description also carried body content that didn't earn its context cost: an itemized sample of 10 of the 33 patterns, and a Wikipedia-attribution line already stated in Reference. Trimmed to state the skill and its trigger once. This doesn't broaden automatic invocation scope, it should fire on the same text it already fires on today.

Maintenance contract

Per AGENTS.md: bumped metadata.version in SKILL.md, .claude-plugin/plugin.json, and the README.md version history together to 2.10.0; added PATTERNS.md to AGENTS.md's Key Files and to the patterns-sync clause; extended scripts/validate-package.py to also check PATTERNS.md contains examples 1-33 in order. python3 scripts/validate-package.py passes. Also added a .gitignore for .DS_Store and other local editor/OS cruft, which wasn't previously ignored.

No numbered patterns were added, removed, or renumbered (still 33).

Version note: #190 is open against this same base commit and also claims 2.10.0 for an unrelated change. Happy to rebase and renumber if #190 lands first.

- SKILL.md keeps watch-words and problem statements for all 33 patterns,
  with a pointer to the matching example, instead of full before/after
  blocks inline. Drops from 412 to 247 lines; no pattern content, numbering,
  or behavior changes.
- New PATTERNS.md holds the full before/after examples, keeping SKILL.md
  lean so a normal invocation doesn't load all 33 of them.
- Frontmatter description trimmed: drops the Wikipedia-attribution line
  (already in Reference) and the itemized 10-pattern list, without
  broadening automatic invocation.
- scripts/validate-package.py now also checks PATTERNS.md contains
  examples 1-33 in order.
- Bumped metadata.version, plugin.json version, and README version
  history to 2.10.0 together per the maintenance contract.
- Added .gitignore for .DS_Store and other local cruft.

Note: blader#190 (open, unmerged, same base commit 523374d) also claims 2.10.0 for an unrelated change. Happy to rebase and renumber if that one lands first.
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