I Got Tired of Repeating Myself.
So I Built This.
Every time I started a new AI session, I was explaining the same project from scratch. So I made a tool that does it once, for good.
Try it — it's free →Here's What Kept Happening
That conversation happened more times than I'd like to admit. Not because the AI isn't capable — it absolutely is. But it starts every session with a blank slate. It doesn't remember your project, your stack, your brand colors, or that one rule about never auto-deploying.
The solution turned out to be pretty simple: an instruction file. A small document that sits in your project folder and gives the AI everything it needs to know before it writes a single line of code.
The less simple part was writing one from scratch every time. So I built something that does it for you.
What I Built
ai-agent-md.com is a free, browser-based wizard. You answer a handful of questions about your project — what you're building, what tools you use, how you like to work — and it generates instruction files tailored to your setup. It supports all the major AI coding tools:
Pick your tools, answer the questions, download the files, drop them in your project folder. Next time you open your AI assistant, it already knows the lay of the land. No more explaining from scratch.
It's Not Just for Developers
That was important to me. I work with all kinds of people — some write code every day, some have never opened a terminal. This tool needed to work for both.
Maybe it's a booking site for your salon, or a portfolio for your photography. You're using AI to help build it, but terms like "framework" and "deployment target" feel foreign. That's okay. There's a helper sidebar that explains every question in plain language. It meets you where you are.
TypeScript, Next.js, Vercel, feature branches, Prettier on save — you've typed this into ChatGPT forty times. Do it once here. Get structured files for every tool you use, plus MCP configs, hooks, and slash commands as ready-to-paste code blocks.
Specific hex codes, a carefully chosen heading font, logo rules you don't want touched. The generated file includes lines like "MUST maintain WCAG AA contrast. Do NOT introduce new colors without approval." Your brand stays yours.
Music AI, lyric generators, creative tools — the wizard adapts. It asks about ragas, taals, song structure, reference artists, lyric languages. This isn't a generic tech form. It was built to understand creative projects because that's what I was building too.
Select multiple AI tools at once, generate all the files in one session, download the whole batch. Same source of truth, consistent instructions, different formats. One click for the lot.
What Actually Goes Into the File
It's not a template with blanks to fill in. The file adapts to your answers — here's the kind of thing it covers:
The creative vision: Your vibe (and what it's not), color palette with hex codes, typography, animation preferences, music direction if applicable, the whole brand identity
The advanced stuff: Custom slash commands for common tasks, MCP server configs for GitHub, Supabase, Playwright, and more — all copy-paste ready. Automated hooks. AI subagents for code review and security
The boundaries: What the AI must always ask before doing — deploying, deleting, pushing, adding dependencies, changing the design. You set the guardrails once
How It Works
Head to ai-agent-md.com
Walk through the guided questions — takes about 5 minutes
Preview your generated files right in the browser
Download and drop them into your project's root folder
Open your AI tool — it reads the file automatically
No account needed. Nothing gets saved or sent anywhere — it all runs in your browser. Works on your phone. Supports dark mode. Fully keyboard accessible. And yes, it's built with vanilla HTML, CSS, and JavaScript — no frameworks, no build step. It practices what it preaches.
Give Your AI the Context It's Missing
The clearer your instructions, the better the work. That's true for people and for AI.
Try it — it's free →