Skip to content
Wade Womersley

wade.one

wade womersley – york based software engineer

  • Home
  • 2026
  • August
  • 25
  • A Definition of Done Is the Best Coding Agent Prompt

A Definition of Done Is the Best Coding Agent Prompt

Posted on August 25, 2026 By
Software Engineer

The weakest coding-agent prompts describe a change and leave completion as an exercise for the agent. Add a button. Fix the API. Refactor the service. That might be enough to generate a diff, but a diff is not the same thing as finished work. The best improvement is usually a clear definition of done.

For me, that means observable checks: the route returns the expected status, the old behaviour still passes, the UI renders at the relevant widths, the migration works on existing data, and the production-safe dry run is clean. OpenAI’s original Codex guidance makes the same practical point from another angle: agents do better with configured environments, reliable tests, and clear documentation.

A definition of done also helps the agent make smaller decisions without repeatedly asking what matters. It can choose an implementation while staying anchored to the acceptance criteria. When something cannot be verified locally, the gap becomes explicit instead of disappearing behind a confident summary. That makes review faster because the evidence arrives with the change.

This is not special prompt magic. It is the same discipline good engineering work has always needed, made more visible because an agent will follow vague instructions literally. Tell it what to change, where the boundary is, and how both of you will know the job is complete. That will improve the result more reliably than adding another paragraph of motivational prose.

Share:

  • Share on Facebook (Opens in new window) Facebook
  • Share on X (Opens in new window) X
  • Share on Tumblr (Opens in new window) Tumblr
  • Share on Pinterest (Opens in new window) Pinterest
  • Share on LinkedIn (Opens in new window) LinkedIn
  • Share on Reddit (Opens in new window) Reddit

Related

Comments

comments

Tags: code-review coding-agents software-delivery testing

Post navigation

❮ Previous Post: Pick and Mix Is Mostly Paying to Make Bad Decisions

You may also like

Software Engineer
GitHub Copilot Usage Metrics Are Becoming Cost Accounting
August 16, 2026
PHP
AWS CloudFormation vs. Azure: The Superior Choice for DevOps
March 28, 2023
Programming
The Case for Smaller Deployments
April 17, 2026
Programming
Why Kotlin Coroutines Are Worth the Learning Curve
April 14, 2026
  • AI
  • artificial intelligence
  • Ego-centric
  • Events
  • Films
  • Food
  • Gaming
  • Gym
  • Hardware
  • Holidays
  • News
  • PHP
  • Programming
  • Random Stuff
  • Reviews
  • Science
  • SEO
  • Software
  • Software Engineer
  • Support
  • Uncategorized
  • Work

Copyright © 2026 wade.one.

Theme: Oceanly News Dark by ScriptsTown