Generate mode

A 7-step wizard that generates production-grade AI instruction files and project docs grounded in your actual tech stack — not generic boilerplate.

When to use Generate mode

  • Starting a new project and want AGENTS.md + CLAUDE.md set up correctly from day one
  • Onboarding a new team member — generate CONTRIBUTING.md from your real repo conventions
  • Open-sourcing a project — generate README + SECURITY + CONTRIBUTING in one pass
  • Retrofitting AI context files onto an existing codebase

Files it generates

README.mdAGENTS.mdCLAUDE.mdSKILL.mdDESIGN.mdCONTRIBUTING.mdSECURITY.mdCONTEXT.md

See Files reference for what each file is and where it goes.

The 7 wizard steps

1

What are you building?

Choose from: website or web app, mobile app, backend or API, tool or library, design system, or something else (you describe it).

2

Who's it for?

Just me (personal project), My team, or The public (open source / anyone). Controls which files are recommended — public projects get CONTRIBUTING.md and SECURITY.md; team projects get a team-focused CONTRIBUTING.md.

3

Which AI tools?

Select the AI coding tools you use: Claude Code, Cursor, GitHub Copilot, Windsurf, ChatGPT/Codex, or "Not sure yet". Selecting Claude Code adds CLAUDE.md to recommendations; any AI tool selection adds AGENTS.md.

4

Tech stack

Paste your package.json, requirements.txt, or any text that describes your stack. MDPilot auto-detects technologies — Next.js, React, FastAPI, Go, Docker, Stripe, Supabase, and many others. Or type it manually.

5

Output style

Choose who will read the output: AI coding agent (terse, machine-parseable), Developer joining the team (engineering-level, project-specific), Non-technical reader (plain language, all terms defined), or I'm learning (explains the why behind each decision). This controls depth and vocabulary throughout all generated files.

6

Files to generate

MDPilot recommends files based on your earlier answers. Tick or untick any combination. Non-technical audience sees a "goal-first" view with plain names and jargon-free reasons; others see technical file names with recommended pre-selected.

7

Review & generate

See a summary of your choices and select an AI model provider. MDPilot generates one file at a time — each takes 5–15 seconds. All generated files pass through the 5-pass token optimizer automatically.

Via MCP: Use the generate_md_file tool to generate any supported file type from inside your IDE. The MCP version reads your actual repo files, so output references real scripts and paths. MCP setup →