Skip to content

Move the Boost guidelines into one clean-code skill - #396

Merged
mikebronner merged 1 commit into
mainfrom
feat/boost-skill
Oct 13, 2026
Merged

mikebronner merged 1 commit into
mainfrom
feat/boost-skill

Conversation

@mikebronner

Copy link
Copy Markdown
Contributor

Boost writes every package guideline into a project's AGENTS.md. Claude Code loads that file whole in every session. clean-code's 95 guideline files added about 89k characters to it.

This change moves every rule into one Boost skill, clean-code. One short guideline stays always on.

What changes

  • The 95 guideline files move unchanged to resources/boost/skills/clean-code/references/. Only pattern-repository.md has one edited line, which links another reference.
  • SKILL.md indexes every reference by topic. Its description tells the agent to activate the skill before it writes, edits or reviews PHP or Blade code.
  • resources/boost/guidelines/clean-code.md is the only guideline left. It names the CleanCode PHPCS standard and points at the skill.
  • Sniff messages now point at the reference files. The message text is the only change in each sniff. The ruleset does not change.
  • BoostSkillTest replaces BoostGuidelinesTest. It checks four things:
    • There is exactly one guideline.
    • Boost can parse the skill's frontmatter.
    • SKILL.md links every reference.
    • Every sniff code appears in an Enforcement table, and every path in a sniff message names a reference file that exists.
  • symfony/yaml is now a declared dev dependency, because the new test parses YAML.

Size

Before After
Always-loaded guideline text 88,931 chars 1,067 chars

Until an agent activates the skill, only its name and its 229-character description are loaded.

Not verified

No consuming project has run boost:install on this branch yet. The skill follows Boost 2.10's parser rules, and the contract test checks that.

Boost writes every guideline into a project's AGENTS.md, so the 95 rule
files loaded about 89k characters into every session. The rules now live
in a Boost skill, resources/boost/skills/clean-code, with one reference
per former guideline and a SKILL.md index. One short guideline (about
1k characters) names the CleanCode standard and tells the agent to
activate the skill before it writes, edits or reviews PHP.

Sniff messages now point at the skill references. The contract test
checks the single guideline, parses the skill frontmatter as Boost does,
checks that SKILL.md links every reference, that every loaded sniff is in
an Enforcement table, and that every resources/boost path in a sniff
message names a reference that exists. symfony/yaml is now a declared
dev dependency, because the contract test parses YAML directly.
@mikebronner
mikebronner merged commit 4dfd55a into main Oct 13, 2026
3 checks passed
@mikebronner
mikebronner deleted the feat/boost-skill branch October 13, 2026 14:05
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