CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

zebbern Hiding risky files

zebbernCLAUDE.md

zebbern-kali-mcp

zebbern/zebbern-kali-mcp/CLAUDE.md

Operational notes for this repo. Every entry is a mistake that has actually been made here, not general advice. The measurements are recorded because they cost real effort and cannot be cheaply re-derived. Read Three rules first; the rest of the file leans on them. Three rules · Release tracks · Releasing · Integration gate · Things that go stale silently · Environment · Timeouts · Background jobs · Output integrity · Session lifetime · Invariants not to break ·…

492mo agoReviewMount

zebbernCLAUDE.md

agent-collab

zebbern/agent-collab/CLAUDE.md

Claude-specific notes on top of the shared agent guide: - Model delegation (repo-specific working preferences, not plugin defaults): - Deep code analysis, architecture validation, security review, and high-stakes refactors → Codex task/rescue with --profile deep (resolves to --model gpt-5.6-sol --effort xhigh); escalate to --profile deep --effort max when a verdict still feels shallow. - Fast iteration, everyday implementation, scaffolding, and the standing pre-merge reviews → Cursor with --model cursor-grok-4.5-high-fast. - Escalation rule: when a task that started on the Cursor…

333mo agoReviewMount

zebbernCLAUDE.md

icron

zebbern/icron/CLAUDE.md

A lightweight personal AI assistant framework with multi-channel support. Channels: Discord, Telegram, WhatsApp, Slack, Feishu Providers: Anthropic, OpenAI, OpenRouter, Together, Groq, Gemini, Zhipu, vLLM Config: ~/.icron/config.json

49mo agoReviewMount

zebbernCLAUDE.md

termstack

zebbern/termstack/CLAUDE.md

TermStack is an Electron + Next.js desktop app that generates websites using 5 CLI agents (Claude Code SDK, Codex, Cursor, Qwen, GLM).

47mo agoReviewMount

CLAUDE.md vs AGENTS.md

About CLAUDE.md

What is CLAUDE.md?

A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.

Where does it go?

At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.

What should it contain?

Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.

CLAUDE.md or AGENTS.md?

Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.