golden-CLAUDE.md
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Warn
- Code scan incomplete — No supported source files were scanned during light audit
Permissions Pass
- Permissions — No dangerous permissions requested
This is a behavioral template for Claude Code. It provides a set of rules and best practices to copy into your `CLAUDE.md` file, guiding the AI to be more honest, rigorous, and safe when generating code or making changes.
Security Assessment
The tool does not execute shell commands, make independent network requests, or request dangerous system permissions. However, it is installed by piping a network request directly into a file via `curl`. This installation method is standard but requires you to trust the remote repository host, as a compromised source could write malicious instructions into your AI configuration. The automated code scanner was unable to analyze the source files during this audit. Overall risk is rated Low, as the tool only manipulates text behavior.
Quality Assessment
The project is licensed under the permissive and standard MIT license. It was actively updated very recently. However, community visibility and trust are currently low, with only 6 GitHub stars. It is distilled directly from Anthropic's official documentation and successful community practices, which adds significant foundational credibility despite the low user base.
Verdict
Safe to use, though users should always review the plain text rules before applying them globally to ensure the behavioral constraints align with their specific development workflows.
A masterpiece of CLAUDE.md, maximize Claude Code proficiency
Golden CLAUDE.md
English | 中文
A copy-paste-ready behavioral template for Claude Code. Research-backed. Oath-style. Under 100 lines.
Distilled from 30+ of the most successful CLAUDE.md files, blog posts, and Anthropic's own documentation into one firm, general-purpose set of behavioral rules.
Quick Start
Install (recommended) — apply globally as your default Claude Code behavior:
mkdir -p ~/.claude && curl -o ~/.claude/CLAUDE.md https://raw.githubusercontent.com/Z-M-Huang/golden-CLAUDE.md/main/CLAUDE.md
This is the recommended approach. Behavioral rules are universal — they don't change per project, so user scope (~/.claude/CLAUDE.md) is the natural home. Your project-root CLAUDE.md stays free for project-specific context (tech stack, test commands, conventions).
Share with your team — commit to your repository as a rules file:
mkdir -p .claude/rules && curl -o .claude/rules/golden.md https://raw.githubusercontent.com/Z-M-Huang/golden-CLAUDE.md/main/CLAUDE.md
Using
.claude/rules/instead of the project root keeps the behavioral rules separate from project context. Claude Code loads both automatically.
Existing CLAUDE.md — paste the golden rules at the top of your file, above your project-specific rules. Behavioral rules go first for maximum attention budget.
If your combined CLAUDE.md exceeds ~120 lines, consider splitting: behavioral rules in
~/.claude/CLAUDE.md, project-specific rules in./CLAUDE.md. See the wiki for details.
What's Inside
| Section | Purpose |
|---|---|
| The Oath | 6 core commitments — certainty, honesty, verification, diligence, understanding, safety |
| Before Every Action | Pre-action checklist — read first, check existing patterns, never assume |
| Honesty & Communication | Anti-sycophancy, surface confusion, push back on bad ideas |
| Verification & Quality | Smallest change, one at a time, Chesterton's fence, prefer editing over creating |
| Critical Evaluation | Falsify before endorsing, visible Risk section, inverted non-trivial default, no generic warnings |
| Safety & Boundaries | Consolidated destructive-action guard, secrets protection, permission-scope clarification |
| Discipline | No shortcuts, no over-engineering, crashes are data, root-cause investigation |
| Response Style | Caveman Lite — drop filler/hedging, keep articles and full sentences, auto-expand for safety |
| Communication & Proposals | Show don't tell — code examples, before/after diffs, ASCII diagrams, comparison tables |
What's NOT Inside
This template is behavioral only. It does not include:
- Code style or formatting rules — use linters (
eslint,prettier,ruff) - Language or framework-specific rules — add those as project-specific rules
- Personality instructions ("act as a senior engineer") — wastes attention budget
- Task-specific workflows — use Claude Code skills instead
Limitations
CLAUDE.md rules are defense-in-depth, not a security guarantee. Be aware:
- Rules may degrade over long conversations — keep sessions focused
- Claude may acknowledge a rule and still violate it (known issue)
- Pair with external enforcement: git hooks, Claude Code permission modes, filesystem permissions
These rules measurably improve compliance. They do not eliminate risk.
Learn More
Visit the wiki for deep dives:
- Why These Rules — philosophy and research backing
- Rule-by-Rule Explanation — rationale for every line
- FAQ — common questions including AGENTS.md compatibility
- Anti-Patterns — what NOT to put in CLAUDE.md
Contributing
Open an issue or PR. Every proposed rule change must justify its attention budget cost — one line added means one line of compliance pressure on every other rule.
License
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found