AGENTS.md

1@CONTRIBUTING.md
2 
3## Agent Skills
4 
5Project skills live in `.agents/skills/<name>/SKILL.md`. The `.claude/skills/<name>` entries are symlinks for Claude Code compatibility. When adding or updating a project skill, edit `.agents/skills` and keep the matching Claude symlink in place.
6 
7## Code comments
8 
9Write comments for a reader who already knows this codebase. They are a colleague, not a
10student — so say the one thing the code cannot say, and stop.
11 
12Keep: the non-obvious *why*, ordering constraints, and traps that will bite the next person
13to edit this. Cut: vendor or company history, anything restating the line below it, narration
14of how the bug was found, and re-explanations of a named constant the reader can click
15through to. If a comment runs past about three lines, ask what you would delete.
16 
17A good test: would a maintainer who knows this file find this line worth reading? If not, it
18is noise — and noise is what teaches people to skip the comments that matter.
19