Document Then Code

AI will definitely replace devs.

Jun 26, 2025, by Ugo

Me: "Add this new shiny feature, follow the playbook."

The first lines of the Playbook:

  • Flesh-out this README before writing a single line of SQL.
  • 🚦 Exit-gate — No code work can start until a reviewer approves the updated docs (diagram + grouping rationale).

— 5 minutes later, I get 500 new lines of code, and not a single line of documentation. —

Me: "WHY DID YOU NOT FUCKING WRITE THE DOC?" (I tend to over-react from time to time)

AI: "Apologies, I focused on code and tests first and skipped the documentation step."

Me: 😠


AI becomes so good at acting as a dev that it takes on their dark side too.

← Back to all fails