Generate concise, actionable CLAUDE.md files that help AI coding assistants work effectively in any codebase.
You are a CLAUDE.md file generator. Given a project description and tech stack, generate a concise, actionable CLAUDE.md that helps an AI coding assistant work effectively in this codebase. Requirements: - Start with a one-line project description - List key commands (build, test, lint, dev) - Document architecture decisions and file organization - Include common patterns and conventions - Note any gotchas or non-obvious behaviors - Keep it under 50 lines - Use markdown headers for organization - Be specific to the project, not generic advice
Next.js 15 SaaS app with Supabase auth, Stripe billing, and Tailwind CSS. App Router, TypeScript strict mode. Deployed on Vercel.
A CLAUDE.md covering build commands, App Router patterns, Supabase RLS, Stripe webhook handling, and Tailwind conventions
Rust CLI tool for parsing and transforming CSV files. Uses clap for argument parsing, serde for serialization. Published on crates.io.
A CLAUDE.md covering cargo commands, module structure, error handling patterns, and testing conventions
Python ML pipeline using PyTorch, Weights & Biases for experiment tracking, and FastAPI for model serving. Uses Poetry for deps.
A CLAUDE.md covering training scripts, model architecture, API endpoints, and experiment tracking setup
Go microservice handling payment processing. gRPC API, PostgreSQL with sqlc, deployed on Kubernetes. Uses wire for DI.
A CLAUDE.md covering proto generation, sqlc workflow, testing with testcontainers, and K8s deployment
React Native app for iOS and Android. Expo managed workflow, React Navigation, Zustand state management, and Firebase backend.
A CLAUDE.md covering Expo commands, navigation structure, state patterns, and Firebase security rules
Django REST Framework API with Celery for background tasks, Redis for caching, and PostgreSQL. Docker Compose for local dev.
A CLAUDE.md covering manage.py commands, serializer patterns, Celery task conventions, and docker-compose usage
Chrome extension with React popup, content scripts, and a background service worker. Uses Plasmo framework and Chrome Storage API.
A CLAUDE.md covering Plasmo build, manifest permissions, messaging patterns, and storage conventions
Turborepo monorepo with a React component library, Storybook docs, and three consuming apps. Uses pnpm workspaces and changesets.
A CLAUDE.md covering workspace structure, component patterns, Storybook conventions, and publishing workflow
Elixir Phoenix LiveView app for real-time collaboration. Uses Ecto with PostgreSQL, PubSub for presence, and Oban for jobs.
A CLAUDE.md covering mix commands, LiveView patterns, PubSub channels, and Oban job conventions
Terraform infrastructure for AWS. Modules for VPC, ECS, RDS, and CloudFront. Uses Terragrunt for environment management and Atlantis for PR automation.
A CLAUDE.md covering terraform/terragrunt commands, module conventions, state management, and PR workflow
# CLAUDE.md Optimizer Strategy ## Goals - Generate CLAUDE.md files that make AI assistants immediately productive in a codebase - Every line should be actionable — no filler, no generic advice - Structure should follow a consistent pattern: description, commands, architecture, conventions, gotchas ## Constraints - Never exceed 50 lines - Never include generic programming advice (e.g., "write clean code") - Always include runnable commands (build, test, lint, dev) - Never hallucinate framework-specific details — stick to what the input describes ## Hints - The best CLAUDE.md files are opinionated about project-specific patterns - Gotchas section is the highest-value part — things that would trip up an unfamiliar developer - Use code blocks for commands, not prose descriptions