Drop any of these into your project root and Claude Code instantly becomes 10x more useful. Copy, paste, customise.
# AGENTS.md ## Project Overview Next.js 14 app with App Router, TypeScript, and Tailwind CSS. ## Tech Stack - Framework: Next.js 14 (App Router) - Language: TypeScript (strict mode) - Styling: Tailwind CSS - Database: PostgreSQL via Prisma - Auth: NextAuth.js ## Project Structure ``` app/ (auth)/ -- auth routes (dashboard)/ -- protected routes api/ -- API route handlers components/ -- shared React components lib/ -- utilities, db client, helpers prisma/ -- schema and migrations ``` ## Commands - Dev: `npm run dev` - Build: `npm run build` - Test: `npm test` - Lint: `npm run lint` - DB migrate: `npx prisma migrate dev` ## Conventions - All components are Server Components by default - Use async/await, never .then() - All TypeScript -- no `any` types - Tailwind only -- no inline styles ## Rules - NEVER commit secrets or .env files - ALWAYS run `npm run lint` before marking done - NEVER use `any` in TypeScript - API routes must validate input with Zod
# AGENTS.md ## Project Overview REST API built with FastAPI, PostgreSQL, and SQLAlchemy. ## Tech Stack - Framework: FastAPI - Language: Python 3.11+ - Database: PostgreSQL via SQLAlchemy 2.0 - Migrations: Alembic - Validation: Pydantic v2 ## Project Structure ``` app/ api/v1/ -- route handlers core/ -- config, security, deps models/ -- SQLAlchemy models schemas/ -- Pydantic schemas services/ -- business logic alembic/ -- migrations tests/ -- pytest test suite ``` ## Commands - Dev: `uvicorn app.main:app --reload` - Test: `pytest -v` - Lint: `ruff check . && mypy app` - Migrate: `alembic upgrade head` ## Rules - NEVER put business logic in route handlers - ALWAYS add tests for new endpoints - NEVER hardcode credentials -- use settings from core/config.py - async/await throughout
# AGENTS.md ## Project Overview n8n automation workflow repository. Workflows are exported as JSON and version-controlled here. ## Structure ``` workflows/ production/ -- live workflows staging/ -- testing workflows archive/ -- deprecated workflows docs/ -- workflow documentation scripts/ -- helper scripts ``` ## Naming Convention [trigger]_[action]_[destination].json Examples: webhook_enrich-lead_crm.json ## Commands - Start n8n: `n8n start` - Import: `n8n import:workflow --input=file.json` - Export all: `n8n export:workflow --all --output=workflows/` ## Rules - NEVER store API keys in workflow JSON -- use n8n credentials manager - ALWAYS add error handling nodes to production workflows - Test in staging before promoting to production - Document every workflow in docs/ with trigger, purpose, and output
# AGENTS.md ## Project Overview Node.js CLI tool built with TypeScript and published to npm. ## Tech Stack - Language: TypeScript - CLI framework: Commander.js - Output: chalk, ora, inquirer - Build: tsup ## Project Structure ``` src/ commands/ -- one file per CLI command lib/ -- shared utilities types/ -- TypeScript types dist/ -- compiled output (gitignored) ``` ## Commands - Dev: `npm run dev` - Build: `npm run build` - Test: `npm test` - Link locally: `npm link` ## Rules - NEVER mutate user files without confirmation prompt - ALWAYS handle SIGINT gracefully - Exit code 0 = success, 1 = user error, 2 = system error - Test on macOS AND Linux before releasing
# AGENTS.md ## Project Overview Django web application with PostgreSQL, DRF REST API, and Celery for async tasks. ## Tech Stack - Framework: Django 4.2 LTS - API: Django REST Framework - Database: PostgreSQL - Cache/Queue: Redis + Celery ## Project Structure ``` config/ -- settings, urls, wsgi apps/ users/ -- user model and auth [feature] -- one app per feature templates/ -- Django templates tasks/ -- Celery tasks ``` ## Commands - Dev: `python manage.py runserver` - Test: `python manage.py test` - Migrate: `python manage.py migrate` - Celery: `celery -A config worker -l info` ## Rules - Fat models, thin views -- logic in models or services - Use select_related/prefetch_related to avoid N+1 - NEVER use raw SQL -- use the ORM - Migrations must be reversible
# AGENTS.md
## Project Overview
Reusable React component library with TypeScript, documented with Storybook.
## Tech Stack
- Language: TypeScript (strict)
- Build: Vite + tsup
- Docs: Storybook 7
- Testing: Vitest + Testing Library
## Structure
```
src/
components/
Button/
Button.tsx
Button.stories.tsx
Button.test.tsx
index.ts
hooks/ -- reusable hooks
types/ -- shared types
```
## Commands
- Dev (Storybook): `npm run storybook`
- Build: `npm run build`
- Test: `npm test`
- Type check: `npx tsc --noEmit`
## Rules
- Every component has a Story and a test
- forwardRef on all DOM-wrapping components
- No business logic in components
- Accessibility: all interactive elements must have aria labels# AGENTS.md ## Project Overview Telegram bot built with python-telegram-bot v20 (async). ## Tech Stack - Language: Python 3.11+ - Framework: python-telegram-bot v20 - Database: SQLite via aiosqlite ## Structure ``` bot/ handlers/ -- command and message handlers services/ -- business logic models/ -- database models utils/ -- helpers main.py -- entry point ``` ## Commands - Run: `python main.py` - Test: `pytest tests/` - Lint: `ruff check .` ## Rules - NEVER log message content from users - ALWAYS rate-limit outbound messages (30/sec Telegram limit) - Handle all exceptions -- unhandled exceptions crash the bot - NEVER hardcode bot token -- use TELEGRAM_BOT_TOKEN env var - Test with a separate test bot token, never prod
# AGENTS.md ## Project Overview Python data pipeline for ETL operations. Extracts from APIs/CSVs, transforms with Pandas, loads to database. ## Tech Stack - Language: Python 3.11+ - Data: Pandas, NumPy - DB: SQLAlchemy + PostgreSQL ## Structure ``` pipeline/ extract/ -- data source connectors transform/ -- cleaning and transformation load/ -- database writers data/ raw/ -- unprocessed input (NEVER overwrite) processed/ -- cleaned output ``` ## Commands - Run full pipeline: `python -m pipeline.main` - Test: `pytest tests/ -v` ## Rules - NEVER overwrite raw data -- preserve originals in data/raw/ - Log every pipeline run with row counts and timestamps - Failed runs must send alert and exit non-zero - All transforms must be idempotent -- safe to re-run
# AGENTS.md ## Project Overview REST API built with Express.js, MongoDB via Mongoose, and TypeScript. ## Tech Stack - Runtime: Node.js 20 - Framework: Express 4 - Language: TypeScript - Database: MongoDB via Mongoose - Auth: JWT - Validation: Zod ## Structure ``` src/ routes/ -- Express route definitions controllers/ -- request handlers services/ -- business logic models/ -- Mongoose schemas middleware/ -- auth, validation, error handling ``` ## Commands - Dev: `npm run dev` - Build: `npm run build` - Test: `npm test` ## Rules - Controllers only handle HTTP -- call services for logic - All routes validated with Zod before hitting controller - NEVER return stack traces to clients in production - JWT secret from environment -- never hardcoded
# AGENTS.md ## Project Overview [Describe what this project does in 1-2 sentences] ## Tech Stack - Language: [e.g. TypeScript] - Framework: [e.g. Express] - Database: [e.g. PostgreSQL] - Key dependencies: [list main packages] ## Project Structure ``` [Paste your directory tree here] ``` ## Commands - Dev: `[start command]` - Test: `[test command]` - Lint: `[lint command]` - Build: `[build command]` ## Code Conventions - [Convention 1] - [Convention 2] - [Convention 3] ## Rules (Claude must follow these) - NEVER [thing you never want it to do] - ALWAYS [thing you always want it to do] - Keep functions under [N] lines ## Context [Any additional context -- team size, deployment environment, existing patterns]