Write the definition of done into AGENTS.md
Every task ends with the same four steps and a reply that names what was skipped. The agent stopped saying "done" on a red build.
Reported by @juliandierker · Verified 2026-11-20
- Agent
- Claude Code
- Model
- claude-opus-5-5
- Stack
- TypeScript, Vite+
Problem
The agent stopped when the code looked finished: no format, no lint, no type check, and a cheerful "all done". What it had not checked was invisible.
Setup

Two hard rules in AGENTS.md:
- Finish every task with: `vp check`, `/cleanory`, then a Conventional Commit
on `main` and a push of `main`. Never `--no-verify`. A push to `main` deploys.
- End replies with what was skipped or not checked.The pre-commit hook runs vp staged, so the first step is also enforced
outside the agent.
What happened
Replies now end like this:
Skipped: no browser check for the empty state.
Not checked: the seed against a real database.I read those two lines first. They tell me where to look before I trust the diff.
Reproduce
Add both rules to AGENTS.md.
Add a pre-commit hook that runs your formatter, linter and type check.
Give the agent a task and read the last two lines of its reply.