If you use Claude Code, you already know what a CLAUDE.md file is. It's the file Claude reads before doing anything in your project — it tells Claude your conventions, your architecture, and the mistakes to avoid.
The difference between a project with a good CLAUDE.md and one without is massive. Without it, Claude writes generic code that technically works but doesn't fit your codebase. With it, Claude acts like a senior dev who's been on the project for months.
The problem I kept running into
Every time I started a new project, I had to write a new CLAUDE.md from scratch. It took 2-4 hours to figure out the right structure for each stack. What do you put in a FastAPI CLAUDE.md? What about a Shopify app? A Rust CLI?
After doing this for the 8th time, I decided to just build a proper pack.
Here are 3 free templates to try right now
Free Template 1: Next.js SaaS (excerpt)
## Critical Rules
- Server Components by default; add "use client" only for event handlers and hooks
- Never use useEffect to fetch data — use Server Components or React Query
- All DB calls go through server-side Supabase client — never expose service key to client
- Auth: protect routes in middleware.ts, not inside page components
- Stripe: sync subscription state via webhooks only — never trust client-sent data
Free Template 2: FastAPI Python (excerpt)
## Code Conventions
### Separation of Concerns
- commands/: CLI parsing and calling lib functions only
- lib/: Pure business logic — no HTTP concerns, no DB
- repository/: All DB queries — none in handlers or services
### Error Handling
- Always wrap errors with context — never return raw errors
- Log once at the top of the call stack; never re-log when wrapping
Free Template 3: AI Agent / LLM App (excerpt)
## Safety & Reliability
- Set max iterations on all agent loops — 10 is a sensible default
- Timeout on individual tool executions (30s)
- Human-in-the-loop checkpoints for destructive actions
- Never trust LLM output as safe input to SQL or shell
- Log every LLM call with input/output for debugging and cost tracking
The full pack
25 templates: Next.js, FastAPI, React Native, Shopify, T3, Django, Electron, Go, React SPA, Supabase Edge Functions, AWS Lambda, Stripe billing, AI agents, e-commerce, Turborepo, Rust CLI, n8n, Vue/Nuxt, Docker Compose, SvelteKit, Python scraper, and a general fill-in-the-blank template.
Full pack at $47: https://alfredolance.gumroad.com/l/uxwvom
Drop questions about specific stacks in the comments.
Top comments (0)