Agent Rules

A GitHub template repository for working with AI agents.

Structure

.
├── .cursor/
│   └── rules/
│       └── agents.mdc         # Cursor rule: forces agents to read AGENTS.md first
├── .githooks/
│   ├── commit-msg             # Validates commit subject line
│   └── pre-commit             # Validates branch name
├── rules/
│   ├── code.md                # Error handling, naming, complexity, boundaries
│   ├── git.md                 # Branching, commits, history, destructive git ops
│   └── writing.md             # Grammar, tone, structure, formatting
├── .editorconfig
├── .gitattributes
├── .gitignore
├── AGENTS.md                  # Entry point; references rule files by activity
├── CLAUDE.md -> AGENTS.md     # Symlink for Claude Code compatibility
├── LICENSE
├── Makefile
└── README.md

Git Hooks

Hooks under .githooks/ check branch names and the first line of each commit message against rules/git.md.

Install

make install-hooks    # core.hooksPath → .githooks, chmod hooks
make uninstall-hooks  # unset core.hooksPath

Adding Rules

Create a new file under rules/ and add a reference in AGENTS.md with a summary and a trigger condition.

Follow the extension rules defined in AGENTS.md: new files must not implicitly override existing rules, and any intentional override must reference the affected file explicitly.