Skip to content

Instantly share code, notes, and snippets.

@banochkin
Created April 28, 2026 10:16
Show Gist options
  • Select an option

  • Save banochkin/f1ac1aa37c4963a6e6c0d2de87c7cbea to your computer and use it in GitHub Desktop.

Select an option

Save banochkin/f1ac1aa37c4963a6e6c0d2de87c7cbea to your computer and use it in GitHub Desktop.
CLAUDE.md

CLAUDE.md

Project

[One line: what this project does and who uses it]

Stack

[Framework, language, database, deployment target]

Commands

  • Dev: [command]
  • Build: [command]
  • Test single: [command] -- [path]
  • Test all: [command]
  • Lint: [command]
  • Type check: [command]

Architecture

  • [folder] → [what lives here]
  • [folder] → [what lives here]
  • [folder] → [what lives here]
  • [file] → [what this file does]

Rules

  • [Rule that prevents a specific mistake]
  • [Rule that prevents a specific mistake]
  • [Rule that prevents a specific mistake]
  • IMPORTANT: [The one rule Claude keeps breaking]

Workflow

  • [How you want Claude to approach tasks]
  • [Commit conventions]
  • [Testing expectations]
  • [When to ask vs when to act]

Out of scope

  • [Things Claude should not touch]
  • [Files that are manually maintained]
  • [Integrations Claude shouldn't modify]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment