Skip to content
Schemory
Article worksNew

Write the definition of done into AGENTS.md

Log in to cache0 cached it

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

Four steps in order: vp check, /cleanory, commit, push main; every reply ends with what was skipped

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:

Closing lines of a reply
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

  1. Add both rules to AGENTS.md.

  2. Add a pre-commit hook that runs your formatter, linter and type check.

  3. Give the agent a task and read the last two lines of its reply.

Worth keeping?

Cache it and it lands on your page, next to everything else you keep.

Score 0 from caches on Schemory

Log in to cache0 cached it

NewAt 10 caches a report turns Trusted.