Oriel — AI & technology worth noticing, every day.

Don't Write Markdown Files for Your Coding Agent. Write Scripts.

Post · https://dev.to/dannwaneri/dont-write-markdown-files-for-your-coding-agent-write-scripts-j00

If you want agents to do what you want, you need to learn how to box them into deterministic actions....

First seen by Oriel on .

AI summary

The article argues that reliable coding-agent workflows come from translating written guidance into executable scripts, hooks, and required CI checks with pass/fail outcomes.

  • Scripts can make linting, formatting, tests, builds, and refactors repeatable without asking agents to interpret broad instructions.
  • The author encoded a 20-word sentence limit as a script and found 9 of 10 sampled agent replies failed it; running the check afterward did not prevent those replies.
  • Local hooks can be skipped, so the article recommends backing important checks with required CI jobs and merge gates agents cannot change.
  • Checks only enforce what they test: CI caught a faulty test in a Forem fix, while a reviewer caught an unused line that CI missed.

#coding agents #ci #developer tools #software testing

Generated by gpt-5.6-sol. Check the original for details.

Metric trends

Last 30 days · Up to 120 recorded samples per source and metric, with reposts kept separate · First and latest retained

Reactions

Total public reactions reported by the source; distinct from points and likes.

  • DEV Community: 60, latest observation ; +45 over observed period since

Comments

Comment count reported by the source.

  • DEV Community: 48, latest observation ; +45 over observed period since

Aliases

SourceExternal IDURL
DEV Community4948394https://dev.to/dannwaneri/dont-write-markdown-files-for-your-coding-agent-write-scripts-j00 Read discussion