Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

CLAUDE.md Templates

Opinionated CLAUDE.md templates for popular stacks, drop into your project root.

License: MIT

What is CLAUDE.md?

CLAUDE.md is a project-level instructions file that Claude Code automatically reads when you start a session in your project. It tells Claude:

  • The project's tech stack and conventions
  • Build, test, and lint commands
  • What patterns to follow and what to avoid
  • Where the important code lives

A good CLAUDE.md cuts your time-to-productive-Claude-session from minutes to seconds.

Available Templates

Stack Template
Next.js (App Router, TypeScript) templates/nextjs/CLAUDE.md
FastAPI (Python 3.12, async) templates/fastapi/CLAUDE.md
Express + TypeScript templates/express-typescript/CLAUDE.md
Go (stdlib + minimal deps) templates/go/CLAUDE.md
Generic scaffold templates/_scaffold/CLAUDE.md

How to use

  1. Find the template that matches your stack (or start from _scaffold).
  2. Copy its CLAUDE.md to your project root.
  3. Customize the sections marked <!-- EDIT: ... -->.
  4. Commit it.

Claude Code automatically loads CLAUDE.md from the project root on every session.

Template structure

Each template follows the same six-section structure:

  1. Project context — what this is, who uses it
  2. Stack & conventions — language, framework, key dependencies
  3. Commands — install, dev, build, test, lint, typecheck
  4. Code style — formatting, naming, comment policy
  5. What to avoid — anti-patterns specific to this stack
  6. Important files — entry points, configs, gotchas

This consistent structure makes it easy to swap templates as your stack evolves.

Contributing

PRs adding new stacks welcome. To contribute:

  1. Copy templates/_scaffold/ to templates/<stack-name>/
  2. Fill out all six sections with stack-specific content
  3. Add an entry to the table above
  4. Open a PR

Stack-specific judgment calls (e.g., "use this ORM, not that one") should be defensible — explain in PR.

Related

License

MIT © 2026 Yazhou Hu

About

Opinionated CLAUDE.md templates for popular stacks (Next.js, FastAPI, Express+TS, Go) - drop into your project root.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors