iamfakeguru/agent-md

951 stars · Last commit 2026-04-27

Production-grade agent directives for autonomous coding agents: Claude Code, Codex, Cursor, Windsurf, Aider.

README preview

# agent-md

Portable contracts for coding agents.

`agent-md` installs one source-of-truth rules file, repo-local hooks,
persistent task state, and a few helper scripts so agents can stop
guessing and start proving their work.

Honest scope:

- Markdown rules are advisory. The agent has to read and follow them.
- Hooks and git hooks are enforceable where the host agent supports them.
- Tests, type-checks, screenshots, and evidence notes are stronger than
  model self-assessment.

## Quickstart

```bash
# From inside your project directory
curl -sL https://raw.githubusercontent.com/iamfakeguru/agent-md/main/install.sh | bash

View full repository on GitHub →