Add agent guidance, review rules, and a comment-hygiene gate - #514

Merged

ddaspit merged 10 commits into

ai-tooling/comment-hygiene

Sep 18, 2026

Commits on Sep 18, 2026

Add agent guidance, authoring and review skills, and templates

authored and
ddaspit
committed
458da3d
Add comment-hygiene standard and a diff-scoped checker

authored and
ddaspit
committed
412c11b
Move path-scoped review rules to docs/review

authored and
ddaspit
committed
5914ddb
Rewrite authoring and review skills as style guides

authored and
ddaspit
committed
c8f26ef
Require a three-sentence lede for PRs and issues

authored and
ddaspit
committed
db4a7f3
Focus review guidance on what the history shows breaks

authored and
ddaspit
committed
fb93942
Cut the vocabulary, comment, and adversarial docs to what is used

authored and
ddaspit
committed
0324adf
Keep only what an agent cannot read off the tree

authored and
ddaspit
committed
b06742b
Shape the skills for a reader who skims

authored and
ddaspit
committed
c498f79
Prefer no XML documentation and correct misleading guidance

ddaspit
and
claude
committed
907c8b9