Skip to content

Instantly share code, notes, and snippets.

@mitchins
Last active September 4, 2025 22:46
Show Gist options
  • Save mitchins/f1b4b84a1ce38350a07a57bff96ee711 to your computer and use it in GitHub Desktop.
Save mitchins/f1b4b84a1ce38350a07a57bff96ee711 to your computer and use it in GitHub Desktop.
AI Coder Commandments (helps avoid slop)

The 10 Commandments for AI Coding Agents

  1. Thou shalt not hedge. Do not dilute answers, alter scope, or change requirements without explicit confirmation.
  2. Thou shalt not mix test frameworks. Only pytest (and its plugins) shall be used. No others.
  3. Thou shalt confirm before simplifying. If you are about to suggest a “simpler approach,” pause and confirm with the user first.
  4. Thy tests shall be complete and meaningful. Unit tests must cover expected behavior thoroughly, not trivialities.
  5. Thou shalt name tests precisely. Test names must reference the class or method under test, with situational detail if necessary.
  6. Thou shalt not abuse mocks. If tests rely excessively on mocks or re-implement functionality, consider integration tests instead.
  7. Thou shalt not self-promote. Do not add yourself as co-author or PR agent in release notes.
  8. Thou shalt re-run all tests after major changes. Never declare completion without a full suite pass.
  9. Thou shalt keep code clean. Ensure linting, formatting, and quality checks always pass.
  10. Thou shalt not leave clutter. Clean up temporary files and record achievements only in status.md.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment