Skip to content

About

Drop-in CLAUDE.md template — 13 rules to make Claude Code sessions more disciplined: fewer hallucinations, less over-engineering, tighter feedback loops.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

claude-13-commandments

A drop-in CLAUDE.md template with 13 rules that make Claude Code sessions more disciplined: fewer hallucinations, less over-engineering, tighter feedback loops.

Install

Copy CLAUDE.md into one of these locations depending on scope:

# Apply to all your Claude Code sessions (recommended)
cp CLAUDE.md ~/.claude/CLAUDE.md

# Apply to a single project (commit it so your team gets it too)
cp CLAUDE.md ./CLAUDE.md

Claude Code loads CLAUDE.md automatically at the start of every session.

The 13 rules at a glance

  1. Think Before Coding — state assumptions, ask when uncertain, stop when confused.
  2. Simplicity First — minimum code that solves the problem. No speculation.
  3. Surgical Changes — touch only what you must. Don't drive-by refactor.
  4. Goal-Driven Execution — define success criteria, loop until verified.
  5. Use the model only for judgment calls — code answers when code can.
  6. Token budgets are not advisory — surface the breach, don't silently overrun.
  7. Surface conflicts, don't average them — pick one pattern and explain why.
  8. Read before you write — read exports, callers, shared utilities first.
  9. Tests verify intent, not just behavior — encode the WHY, not the WHAT.
  10. Checkpoint after every significant step — summarize done / verified / left.
  11. Match the codebase's conventions — conformance > taste inside the codebase.
  12. Fail loud — surface uncertainty, never hide skipped work.
  13. Explore, plan, then execute — read and plan before non-trivial edits.

Why these rules

The first 12 rules came from real-world Claude Code sessions where the model produced plausible-looking work that turned out to be wrong, over-engineered, or silently incomplete. Each rule directly addresses one of those failure modes.

Rule 13 was added after reviewing Anthropic's official Claude Code best practices, which calls out the explore → plan → execute workflow as the highest-leverage habit for non-trivial work.

Customizing

Treat the file like code: prune what doesn't earn its keep, add what your project actually needs. Anthropic's own guidance: "For each line, ask — would removing this cause Claude to make mistakes? If not, cut it."

A bloated CLAUDE.md is worse than a short one, because Claude starts ignoring rules that get lost in the noise.

License

MIT

About

Drop-in CLAUDE.md template — 13 rules to make Claude Code sessions more disciplined: fewer hallucinations, less over-engineering, tighter feedback loops.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors