AGENTS.md
Download ↓The file every AI session reads first. Project rules, conventions, hard rules.
Drop in repo root. Read by Claude Code, Cursor, Codex CLI, Windsurf.
The toolbox.
Interactive utilities for vibe coders. Generators, scanners, templates. Everything free and open source. No signup.
Generators
AGENTS.md & PRD Generator
Fill in the blanks below, copy or download the markdown. Inputs save to your browser, never to a server.
Preview · AGENTS.md
# AGENTS.md > The file every AI coding session reads first. Keep it short, specific, and updated. ## Project **Name:** [Your project] **One-line:** [What it does in plain English. One sentence.] **Stack:** Next.js 16, TypeScript, Tailwind v4, Supabase, Vercel ## Conventions - kebab-case filenames - PascalCase component exports - no file over 500 lines ## Hard rules 1. **Never overwrite existing code unless explicitly asked.** Read before writing. 2. **No new state, deps, or files unless I ask.** Use what's already imported. 3. **Every new feature needs 3 tests:** 1 expected use, 1 edge case, 1 failure case. 4. **No-touch list:** `.env`, `.env.local`, `package-lock.json`, `next.config.ts`, `/public`. ## Memory bank The `memory-bank/` folder holds long-lived context. Read before any task: - `@architecture.md` — file map, where state lives, server/client boundaries (always read) - `@design-doc.md` — the PRD, what we're building and why (always read) - `progress.md` — completed steps, current state - `implementation-plan.md` — ordered task list ## Session kickoff At the start of every chat: > Read AGENTS.md, docs/PRD.md, and memory-bank/@architecture.md before doing > anything. Summarize what you understand before coding. ## Debugging contract When something breaks: 1. Don't refactor. Reproduce the bug in isolation. 2. Add logging, run `git bisect` if the bug is regression-shaped. 3. Show me the minimum diff that fixes it. 4. Only then suggest broader cleanup. --- _Template from [vibeprompt.tech](https://vibeprompt.tech/generator). Edit freely._
All inputs save to your browser. Nothing leaves your machine.
Templates
Plain markdown files. Download, fill in, commit to your repo. Each one is under 100 lines and stack-agnostic — adapt to your project.
PRD.md
Download ↓Product Requirements Document. What you're building, for whom, with what success criteria.
Save under docs/. Reference from AGENTS.md.
architecture.md
Download ↓File map, where state lives, server/client boundaries. The mental model of the codebase.
Save under memory-bank/. Prefix with @ to set as always-read.
implementation-plan.md
Download ↓Ordered task list with acceptance criteria. The agent's punch list.
Save under memory-bank/. Update as tasks complete.
MEMORY.md
Download ↓Session continuity. Decisions made, gotchas discovered, in-progress threads.
Save under memory-bank/. Every agent appends when it finishes.
Missing a tool?
Tell us what to build next.
The toolbox grows when vibe coders tell us what’s painful. Open an issue with the tool you wish existed — even if it’s “a thing that turns my messy notes into an AGENTS.md” or “a checker for whether my prompt is too long.”
Everything here
is open source.
Fork the repo, swap in your branding, ship your own toolbox. MIT licensed, no strings.