Repository navigation
Move the Boost guidelines into one clean-code skill - #396
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
resources/boost/skills/clean-code/references/. Onlypattern-repository.mdhas one edited line, which links another reference.SKILL.mdindexes 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.mdis the only guideline left. It names the CleanCode PHPCS standard and points at the skill.BoostSkillTestreplacesBoostGuidelinesTest. It checks four things:SKILL.mdlinks every reference.symfony/yamlis now a declared dev dependency, because the new test parses YAML.Size
Until an agent activates the skill, only its name and its 229-character description are loaded.
Not verified
No consuming project has run
boost:installon this branch yet. The skill follows Boost 2.10's parser rules, and the contract test checks that.