# Awesome CLAUDE.md — Project Config Best Practices

> Community collection of CLAUDE.md templates and best practices for configuring Claude Code per-project. Includes templates for monorepos, web apps, Python projects, and team workflows. 3,000+ stars.

## Install

Paste the prompt below into your AI tool:

## Quick Use

Create a `CLAUDE.md` file in your project root:

```markdown
# CLAUDE.md

## Project Overview
This is a Next.js 14 app with TypeScript, Tailwind CSS, and Prisma ORM.

## Commands
- `npm run dev` — Start dev server
- `npm run test` — Run tests
- `npm run lint` — Run ESLint + Prettier

## Code Style
- Functional components only, no class components
- Use Server Components by default
- State: Zustand for client, React Query for server
- Naming: PascalCase components, camelCase functions, kebab-case files

## Architecture
- `src/app/` — Next.js App Router pages
- `src/components/` — Shared UI components
- `src/lib/` — Utilities and helpers
- `src/server/` — Server-side logic and API

## Do NOT
- Do not use Redux or Context API for state
- Do not create CSS modules — use Tailwind only
- Do not add comments explaining obvious code
```

---

## Intro

Awesome CLAUDE.md is a community collection of CLAUDE.md templates and best practices for configuring Claude Code on a per-project basis with 3,000+ GitHub stars. A CLAUDE.md file in your project root tells Claude Code about your codebase conventions, tech stack, architecture, and team preferences — so it writes code that fits your project from the first interaction. This collection includes ready-to-use templates for monorepos, web apps, Python projects, APIs, and team workflows. Best for developers who want Claude Code to follow project conventions without repeating instructions. Works with: Claude Code. Setup time: under 2 minutes.

---

## Template Library

### Next.js + TypeScript
```markdown
# CLAUDE.md
## Stack: Next.js 14, TypeScript, Tailwind, Prisma
## Commands: npm run dev | test | lint | build
## Style: functional components, Server Components default, Zustand + React Query
## DB: Prisma with PostgreSQL, always use transactions for writes
```

### Python FastAPI
```markdown
# CLAUDE.md
## Stack: Python 3.12, FastAPI, SQLAlchemy, Alembic
## Commands: uvicorn main:app --reload | pytest | ruff check
## Style: type hints everywhere, Pydantic models for all I/O, async by default
## DB: SQLAlchemy async with PostgreSQL, Alembic for migrations
```

### Go Microservice
```markdown
# CLAUDE.md
## Stack: Go 1.22, Chi router, sqlc, Docker
## Commands: go run . | go test ./... | golangci-lint run
## Style: standard Go project layout, error wrapping with fmt.Errorf
## Testing: table-driven tests, testcontainers for integration
```

### Monorepo
```markdown
# CLAUDE.md
## Structure: Turborepo monorepo
## Packages: apps/web (Next.js), apps/api (Express), packages/ui (shared components)
## Commands: turbo dev | turbo test | turbo build
## Conventions: shared types in packages/types, all packages use TypeScript strict
```

### Team Configuration
```markdown
# CLAUDE.md
## Team Conventions
- PR titles: type(scope): description (conventional commits)
- Branch naming: feat/JIRA-123-description
- Tests required for all new functions
- No direct pushes to main — always PR

## Review Checklist
- [ ] Tests pass
- [ ] No console.log in production code
- [ ] Error handling for all API calls
- [ ] Accessibility: all interactive elements have labels
```

## Best Practices

### Keep It Focused
- Only include conventions Claude Code might get wrong
- Skip obvious things (Claude already knows language syntax)
- Update when you notice Claude making mistakes

### Structure Matters
- Start with project overview (1-2 lines)
- Commands section for common tasks
- Code style for conventions
- Architecture for file structure
- "Do NOT" section for anti-patterns

### Key Stats
- 3,000+ GitHub stars
- 20+ ready-to-use templates
- Covers 10+ tech stacks
- Community-contributed best practices
- Updated monthly

### FAQ

**Q: What is CLAUDE.md?**
A: A markdown file in your project root that configures Claude Code with project-specific conventions, commands, architecture, and coding standards.

**Q: Where does CLAUDE.md go?**
A: In the root of your project directory. Claude Code automatically reads it at the start of every conversation.

**Q: Can I have multiple CLAUDE.md files?**
A: Yes, you can place them in subdirectories for package-specific instructions in monorepos.

---

## Source & Thanks

> Community-maintained collection. Licensed under MIT.
>
> [awesome-claude-md](https://github.com/awesome-claude/awesome-claude-md) — ⭐ 3,000+

Thanks to the community for codifying what makes a great CLAUDE.md.

---

<!-- ZH -->

## 快速使用

在项目根目录创建 `CLAUDE.md`:

```markdown
# CLAUDE.md
## 项目: Next.js 14 + TypeScript + Tailwind
## 命令: npm run dev | test | lint
## 风格: 函数式组件，Server Components 优先
## 禁止: 不用 Redux，不写 CSS modules
```

---

## 简介

Awesome CLAUDE.md 是一个 CLAUDE.md 模板和最佳实践的社区合集，GitHub 3,000+ stars。包含 monorepo、Web 应用、Python 项目等 20+ 即用模板。适合想让 Claude Code 自动遵循项目规范的开发者。

---

## 来源与感谢

> Community-maintained collection. Licensed under MIT.
>
> [awesome-claude-md](https://github.com/awesome-claude/awesome-claude-md) — ⭐ 3,000+

---
Source: https://tokrepo.com/en/workflows/e0565f2a-21a4-4f82-8ba2-1f77ac970144
Author: Prompt Lab