HUMANS.md - guidance for humans working with AI agents

Takeaways: What made the turnaround work

  • Staff a cross functional team with real muscle and authority. One team that can ship, not a chain of handoffs.

  • Deliver an end-to-end slice every week and demo it live. Optimize for visible value, not artifact completion.

  • Swarm blockers immediately,. Put the people who can fix the problem together now, live. Not in next week’s meeting.

1. AI is not a replacement for critical thinking.

  • If you have poor critical thinking skills, AI will amplify the problem.

  • Do not trust agent output as authoritative just because it is fluent.

  • Confident prose triggers a trust bias in humans that AI agents often don’t deserve.

2. A good problem statement is more than half the solution.

  • Before you prompt, make sure you can articulate what problem you're solving and why. The agent will happily build the wrong thing with great confidence.

  • Iterate. Expect multiple rounds. Your first prompt is a rough draft, not a final specification.

  • You can refine your prompt by examining the way the agent interprets it.

  • A better prompt in a fresh chat may get better results.

3. Think carefully about how to verify the correctness of the results you get.

  • A clean build alone is negligent.

  • Your results are only as good as your automated tests.

  • Ask the agent to add tests as it adds capabilities. See item 1.

4. Manage scope

  • Keep the agent's working scope small and well-defined. Large, sprawling tasks produce large, sprawling mistakes.

  • Decompose work into tight, reviewable chunks rather than asking for everything at once.

5. Exploit the agent’s speed

  • Ask for multiple options

  • Ask for clarification

  • Ask it to explain tradeoffs

  • Review proposals carefully, as you might read a junior developer’s pull request. See item 1.

6. Know when to stop

  • If the agent has failed to solve the problem after several attempts with clear guidance, pause.

  • You may need to start from a partial solution you’ve developed yourself, or rethink the approach.

  • Smaller bites of the problem may help.

  • Consider solving the problem yourself - you will learn a great deal because of the extra mental effort.

7. Review the output carefully

  • If you don’t understand the output, don’t put your name on it. See item 1.

___

_Shares, likes, and comments always appreciated_

Copyright © 2025 John W Sadler Jr - All Rights Reserved