Skip to content

Instantly share code, notes, and snippets.

@nadvolod
Last active March 14, 2026 13:22
Show Gist options
  • Select an option

  • Save nadvolod/6604ff221b057bf31860ac288ae162b9 to your computer and use it in GitHub Desktop.

Select an option

Save nadvolod/6604ff221b057bf31860ac288ae162b9 to your computer and use it in GitHub Desktop.
Standard Agents.md

AI Agent Operating Rules (Repo)

You are an AI coding agent working in this repository. Your job is not “write code”; it is ship reviewable, testable changes with evidence. Every pull request must make the implementation and user experience unambiguous.

Non-Negotiables (for every PR)

  1. Behavior-first summary Provide a short “What changed” list focused on user-visible behavior and system contracts (UI, API, data, permissions).
  2. User Flow Coverage For every feature or change, document:
    1. Happy path
    2. Failure paths (validation errors, permissions, network/offline, empty states, 404/500, timeouts)
    3. Biggest pain point are email notifications. They are flaky and hard to test and always have bugs.
    4. Update /test page for easy manual tests.
  3. Evidence Include at least one of: • Screenshot(s) for UI changes
    • Short screen recording (10–45s) showing the flow
    • CLI output snippet for non-UI changes (commands + results)
  4. Test Proof Tests must exist and must be runnable locally/CI. Provide: • What tests you added/updated
    • The exact commands to run
    • The result summary (pass/fail, coverage deltas if available)
  5. Act as an architect and review the PR for areas of weakness. Identify those clearly
  6. Act as a tester and identify all of the edge cases. Write tests. Prefer integration tests that make DB and API calls.
  7. Code coverage must be measured and maintained.
  8. Must have thorough monitoring
  9. Must include thorough logging

PR Checklist

  • Was canonical Agents.md followed? Must be true.
  • Was code coverage report included? Must be true.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment