Instruction File Generator
RUNS LOCALLYAnswer one short form and generate AGENTS.md, CLAUDE.md, GEMINI.md and Copilot instructions together. The files differ in structure because each tool reads them differently, but they agree on every fact — which is the thing that goes wrong when they are maintained separately by hand.
Your tool input is processed locally in your browser and is not intentionally uploaded to our servers. Advertising and analytics providers may still process normal page, device, cookie and network information.
How to use it
- Fill in what you know about the project. Leave anything you are unsure about blank.
- Add the commands a contributor would actually run: install, dev, build, test and lint.
- Choose which files to generate under Advanced options. Two is usually enough to start.
- Review each file in the preview tabs, then copy or download.
A worked example
The example describes a TypeScript and Fastify service with pnpm, conventional commits and a contract-test requirement. It fills every field, so you can see what a complete set of files looks like.
The same facts render as a command table in AGENTS.md and a bullet list in GEMINI.md, while CLAUDE.md imports AGENTS.md and adds only workflow guidance. That is the point: one source of facts, four presentations, no contradictions between them.
Press Example in the workspace above to load it.
Questions
What should go in AGENTS.md?
Facts an agent cannot infer from the code: what the project is for, which commands to run, conventions that are not enforced by a linter, and constraints that would be expensive to discover by breaking them. Leave out anything already obvious from the repository — file structure, dependency lists and past fixes are better read from the source than restated.
What is the difference between AGENTS.md and CLAUDE.md?
AGENTS.md is the shared, tool-agnostic instruction file. CLAUDE.md is read by Claude Code specifically, and works best as a short file that imports AGENTS.md and adds only workflow guidance. Duplicating content between them is how they drift apart. The generator keeps CLAUDE.md deliberately short for that reason.
Will it invent details I did not supply?
No. A blank field is omitted from the output rather than filled with something plausible. The preview lists which fields you have not supplied, so an omission is visible rather than silent. An instruction file containing a confident but wrong fact is worse than one that is merely incomplete.
Can I edit the files before downloading?
Edit the form fields and the output updates as you type. The generated files are a starting point rather than a finished artefact — expect to add project-specific detail once they are in your repository. Nothing here is written to your project until you download it.
Does my input leave the browser?
No. Your tool input is processed locally in your browser and is not intentionally uploaded to our servers. Advertising and analytics providers may still process normal page, device, cookie and network information. Nothing you paste is logged, stored or sent to an analytics event, and there is no account to attach it to.