kw-optimize-agents-project
Optimize Agents Project
Rewrite the project's instruction file (AGENTS.md or CLAUDE.md) so it stays a briefing instead of becoming documentation. Verbose sections move to reference docs that are read on demand, and a one-line pointer takes their place.
Why ~150 lines is the line: the instruction file is loaded whole into every conversation, so every line is paid on every turn. Past roughly 150 lines it stops being a briefing and becomes documentation that most turns never need.
When to use
Manual only, via /kw-optimize-agents-project:
- the instruction file has grown past ~150 lines
- auto-generated blocks (GSD markers, a generated skills table) take up most of it
- a refactor changed the architecture and the file now describes two projects at once
Out of scope: checking whether reference docs still match the code (/kw-audit-references) and producing .planning/codebase/ in the first place (/gsd-map-codebase). This skill moves text, it does not verify it. If the content may be stale, audit first, move second.