AI-First DX
Every generated project ships with configuration files that make AI coding tools immediately productive. You choose which tool-specific configs to include via --ai-tools.
What's included
| File | Used By | Included when |
|---|---|---|
AGENTS.md | Cursor, Copilot, Codex, Windsurf | Always (base) |
ARCHITECTURE.md | All agents + humans | Always (base) |
CLAUDE.md | Claude Code | --ai-tools claude |
.cursor/rules/project.mdc | Cursor | --ai-tools cursor |
.cursor/rules/nextjs.mdc | Cursor | --ai-tools cursor |
.cursor/rules/database.mdc | Cursor | --ai-tools cursor |
.cursor/rules/auth.mdc | Cursor | --ai-tools cursor |
.cursor/rules/testing.mdc | Cursor | --ai-tools cursor |
.cursor/rules/env.mdc | Cursor | --ai-tools cursor |
.gemini/GEMINI.md | Gemini Code Assist | --ai-tools gemini |
Selecting AI tools
# Include everything (default)
npx create-launchframe my-app --ai-tools all
# Only Cursor and Claude
npx create-launchframe my-app --ai-tools cursor,claude
# Base only (AGENTS.md + ARCHITECTURE.md)
npx create-launchframe my-app --ai-tools noneIn interactive mode, the CLI presents a multi-select checkbox prompt.
What agents learn
- Tech stack: exact versions of Next.js, React, TypeScript, Drizzle, Better Auth
- Commands: lint, typecheck, test, build, db operations
- Rules: server/client boundaries, import patterns, naming conventions
- Where to find things: router table mapping concerns to files
- MUST DO / MUST NOT DO: explicit guardrails for code generation
Modules
| Module | Files | Depends on |
|---|---|---|
ai-dx | AGENTS.md, ARCHITECTURE.md | quality-baseline |
ai-dx-cursor | .cursor/rules/*.mdc | ai-dx |
ai-dx-claude | CLAUDE.md | ai-dx |
ai-dx-gemini | .gemini/GEMINI.md | ai-dx |
The base ai-dx module is always included when any AI tool is selected. The sub-modules are resolved dynamically from your --ai-tools selection.
Customization
After generation, edit any of these files to match your evolving project conventions. The .cursor/rules/*.mdc files use glob patterns to auto-activate when editing matching files.