YourAITools

AGENTS.md Templates + Checker: 11 Stacks, Real Commands

Get an AGENTS.md that lists commands that actually run in your repo, and a check that tells you when it goes stale.

AGENTS.md Templates + Checker: 11 Stacks, Real Commands product illustration

What it does

AGENTS.md is the one instructions file that Codex, GitHub Copilot, Cursor, Devin, Claude Code (when there is no CLAUDE.md) and many other agents read. This pack gives you a good one for your stack in a minute, with your repo's real commands, plus scoped folder files and a checker that catches the things that silently go stale.

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 13 tests OK on Python 3.13 and 3.10.

Real terminal output from AGENTS.md Templates + Checker: 11 Stacks, Real Commands: demo and passing tests

What's inside

  • 11 root templates (templates/<stack>/AGENTS.md, 45-63 lines each): Next.js 16, Django 6, Rails 8, Supabase, Laravel 13, FastAPI, SvelteKit 3, Expo SDK 58, Go 1.27, Node.js + TypeScript, Python. Each has Project, Commands, Layout, stack conventions (version-checked Nov 2026), How to work here, Before you finish, and a ## Code Review Rules section (Codex code review reads it).
  • 57 path-scoped rules that init --nested turns into folder-level files such as app/models/AGENTS.md or db/migrate/AGENTS.md, only for folders that exist in your repo.
  • tools/agentsmd.py (Python 3.9+, no dependencies): commands, init, check, list.

Use it

python3 tools/agentsmd.py commands /path/to/repo                 # what it found: package manager, scripts, Makefile, pyproject, go.mod, Cargo.toml...
python3 tools/agentsmd.py init /path/to/repo --nested            # dry run (stack auto-detected; or --stack rails)
python3 tools/agentsmd.py init /path/to/repo --nested --write    # never overwrites without --force
python3 tools/agentsmd.py check /path/to/repo                    # run in CI with --strict to fail on warnings too

What check catches

ProblemLevel
pnpm lint / npm run x with no such script in package.json; make x / just x / composer x with no such targeterror
npm ... in a repo that uses pnpm/yarn/bun (lockfile or packageManager)warn
./scripts/x.sh or bin/x that does not exist; paths in backticks that were moved or renamedwarn
Codex limits: an AGENTS.override.md hiding the AGENTS.md in the same folder; the root-to-folder chain over 32 KiB (project_doc_max_bytes default); empty files (skipped)warn
a CLAUDE.md without @AGENTS.md (Claude Code then reads only CLAUDE.md); a GEMINI.md or Gemini settings that will not load AGENTS.mdwarn / note
leftover <PLACEHOLDER> / TODO, files over 250 lines, no runnable command at allwarn
tokens, keys or private keys pasted inerror

How agents load AGENTS.md (Nov 2026)

  • Codex: reads ~/.codex/AGENTS.md, then one file per folder from the repo root down to the working folder (AGENTS.override.md wins over AGENTS.md), concatenated, up to 32 KiB by default.
  • GitHub Copilot: the nearest AGENTS.md in the tree takes precedence; used alongside .github/copilot-instructions.md.
  • Claude Code: reads AGENTS.md when there is no CLAUDE.md; if you keep both, put @AGENTS.md in CLAUDE.md.
  • Gemini CLI: reads GEMINI.md unless context.fileName in settings includes AGENTS.md.

Files

  • templates/, tools/agentsmd.py (+ stackdata.json, detect.py, rulesfmt.py), tools/demo.sh
  • examples/node-api (a stale AGENTS.md with 9 problems) and examples/rails-app (for init --nested)
  • skills/agents-md/ so Claude Code can run it (claude --plugin-dir ./agents-md-templates)
  • tests/ 13 tests

Honest limits

  • Command detection covers npm/pnpm/yarn/bun scripts, Make, just, composer, Django, Rails, pytest/ruff/mypy (uv, poetry), Go and Cargo. Other build tools: fill Commands by hand.
  • check verifies that commands and paths exist, not that they succeed; run them.
  • Loading rules above were checked against each tool's docs in November 2026 and can change.
  • Not affiliated with OpenAI, GitHub, Anthropic, Google or the agents.md project.

Format and license

Zip, 62 KB, v1.0, 39 files. You may use and modify this kit for your own work and for clients you serve, including paid client work. Not affiliated with OpenAI, GitHub, Anthropic, Google or the agents.md project.

FAQ

Which agents read AGENTS.md?
Codex, GitHub Copilot, Cursor, Devin and many others; Claude Code reads it when there's no CLAUDE.md, or when CLAUDE.md imports @AGENTS.md.
Will it overwrite my AGENTS.md?
No. init is a dry run by default and never overwrites without --force.
Can I run the checker in CI?
Yes: agentsmd.py check . --strict exits non-zero on problems.
How do I get the files?
Pay by card right here on youraitools.co: your download links appear on this page the moment the payment goes through (claim window: 72 hours, up to 5 downloads per 7 days). Need the files re-sent later? Email hello@youraitools.co.
Refunds?
Email hello@youraitools.co within 14 days if it doesn’t work and we can’t fix it.
Can I pay with crypto?
Yes. Pay the same price in USDC or USDT on Base, Ethereum, Arbitrum, Optimism, Polygon or Solana from the "Pay with crypto" button, with no account or KYC. We check the payment on-chain and show your download links as soon as it confirms.

Get AGENTS.md Templates + Checker: 11 Stacks, Real Commands

AGENTS.md templates and examples for Next.js, Django, Rails, Go, Python and 6 more, filled with your repo's real commands, plus a checker for stale commands.

$15 one-time

Buy and downloadPay with crypto

Save with a bundle

Pairs well with

Download$119

Agent Builder Bundle

Swarm Operator Kit + x402 Builder Skills + MCP Starter Kit. $119 instead of $157.

View Agent Builder Bundle
Download$89

Swarm Operator Kit

Run a team of AI agents as a business: charter, 5 roles, 6 skills, routines and scripts.

View Swarm Operator Kit

Related

1 email a week: new x402 + MCP tools and free kits.

Short weekly digest of new x402 + MCP tools and free kits, including the MCP OAuth Checker. No spam, unsubscribe any time.