Skip to content

AGENTS.md Generator

Presets:

Monorepo packages (optional)

No packages added. Use this for monorepos with per-package commands.

AGENTS.md

Structure looks complete — no lint issues.

What This Tool Does

The AGENTS.md Generator builds a best-practice AGENTS.md file that tells coding agents how to work in your repo. It produces command-first sections for build, test, and lint, records your conventions, and writes verifiable done-criteria, so agents follow the same rules a new teammate would. It runs in your browser with no signup.

Last updated:

This tool is provided as-is for convenience. Output should be verified before use in any production or critical context.

Agent Invocation

Best Path For Builders

Browser workflow

Runs instantly in the browser with private local processing and copy/export-ready output.

Browser Workflow

This tool is optimized for instant in-browser execution with local data handling. Run it here and copy/export the output directly.

/agents-md-generator/

For automation planning, fetch the canonical contract at /api/tool/agents-md-generator.json.

How to Use AGENTS.md Generator

  1. 1

    Pick a preset

    Start from Node/TypeScript, Python, Go, or Monorepo to pre-fill sensible commands and conventions, then edit them to match your project.

  2. 2

    Enter your exact commands

    Fill the setup, build, test, lint, and run fields with the real invocations an agent should run. Command-first beats prose every time.

  3. 3

    Define done-criteria

    Spell out how an agent verifies a change is complete: tests pass, type-check clean, lint clean. This is the highest-value section.

  4. 4

    Check the lint panel

    Review the warnings for empty command sections or placeholder text like TODO, and fill the gaps before shipping the file.

  5. 5

    Copy or download AGENTS.md

    Copy the generated Markdown or download the AGENTS.md file and drop it in your repository root.

Frequently Asked Questions

What is an AGENTS.md file?
AGENTS.md is an open convention adopted across coding agents. It gives an agent the exact commands, conventions, and done-criteria for your repo, so it works the way your team expects.
How does this generator work?
Fill in your setup, build, test, lint, and run commands plus your conventions, and it assembles a clean, command-first Markdown file. A built-in lint flags empty command sections and vague placeholders like TODO.
What makes a good AGENTS.md?
Exact command invocations (not prose), explicit code-style rules, and concrete 'how to verify your change is done' criteria. Agents follow commands far more reliably than vague descriptions.
Does it support monorepos?
Yes. Use the Monorepo preset or add per-package sections with their own paths and commands, so an agent knows which workspace flag to pass for each package.
Is my input sent anywhere?
No. The file is assembled entirely in your browser. Nothing you type is uploaded, logged, or stored on a server.