← ClaudeAtlas

boyscoutlisted

Leave things better than you found them: silently archive improvement opportunities to a backlog during the primary task; the user opts in to attack a finding now (worktree), route it to a ticket, or clean the backlog on demand
juanyque/agent-brain · ★ 1 · AI & Automation · score 70
Install: claude install-skill juanyque/agent-brain
# boyscout Apply the Boy Scout Rule: leave things better than you found them. While working on a task, scan the surrounding context for improvement opportunities — flaky tests, broken scripts, missing coverage, dead code, interesting refactors, outdated docs, skill gaps, etc. New findings are silently archived to the backlog so the primary task is not interrupted. When the user explicitly invokes `/boyscout` (or `/boyscout clean` / `/boyscout deep`), present the accumulated findings and let them attack each in an isolated worktree (branched from an up-to-date base branch), route to a detailed ticket, or leave in the backlog for later. **Golden rule: default to silent archive — never auto-fix without explicit user opt-in.** New findings are added to the backlog without interrupting the primary task. Triage and fixes are opt-in: the user invokes `/boyscout` to see the selection form, or explicitly says "fix item N now" during the scan. When a finding is attacked from the backlog, success consumes the entry (deletes it). ## When to use Invoke `/boyscout` when you notice opportunities while working on a primary task: - Flaky or intermittently failing tests - Scripts that don't behave as expected or are clearly broken - Refactoring opportunities (extract function, rename, simplify) - Missing or insufficient test coverage - Dead code: unused imports, unreachable branches, obsolete flags - Leftover TODOs or FIXMEs with a clear path forward - Side tasks uncovered during investig