agent-coach

agent-coach

A coach for your Claude Code agent — analyzes sessions to improve your repo and generate better PRs.

Each command reads your latest session, extracts the signal, and gives you — or the active Claude Code agent — something to act on.

Install

npm install -g agent-coach
agent-coach setup

setup installs slash commands into ~/.claude/commands/. After restarting Claude Code, all commands are available in any session.

Usage

Run commands inside a Claude Code session. agent-coach automatically picks up the current session — no path needed.

Improve your repo

Evaluate a quality dimension and tell Claude what to do with the findings:

/environment fix the issues you find
/instructions update CLAUDE.md based on these findings
/navigation suggest structural improvements
/contract tighten the types
/tests add missing coverage
/verification document the verification commands in CLAUDE.md

Generate a contribution report

Turn the session into a PR description or a saved file for repo history:

/contribution write a PR description from this
/contribution --save and commit the file

Dimensions

Command	What it evaluates
environment	Clean setup — deps, env vars, build and test commands
instructions	CLAUDE.md quality — are agents told what they need?
navigation	Codebase orientation — can an agent find things quickly?
contract	Type and schema surface — are data shapes explicit?
tests	Test safety net — do tests give an agent confidence?
verification	Self-verification — can an agent confirm its own work?

Direct CLI usage

All commands work outside Claude Code too, with an explicit session file:

agent-coach environment ~/.claude/projects/.../session.jsonl
agent-coach contribution --save ~/.claude/projects/.../session.jsonl