agentleFS
Sign inSign up

CLAUDE.md examples from real projects

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

Best matches · from page 6Worked for most · soon
weave-osCLAUDE.md

router

weave-os/router/CLAUDE.md

write. - **Non-tautological tests** — every test must assert behavior that breaks if prod code deleted. ## Layer model and import rules Three concentric layers. Imports flow inward only. ``` +-------------------------------------------------------------------+ | cmd/router/main.go (composition root

5.4k16d agoDiscuss
SenteLabsAICLAUDE.md

OpenExecutive

SenteLabsAI/OpenExecutive/CLAUDE.md

default > `./episodic_memory.db` unless the test isolates it. A test module that > exercises audited code (alerts review, sweeps) without monkeypatching > `openexecutive.audit.log_event` (or the audit logger's DB) leaks rows that

5.3k5d agoReads credentialsDiscuss
SaladDayCLAUDE.md

cc-switch-cli

SaladDay/cc-switch-cli/CLAUDE.md

issues. - Validate every finding against the code. Make minimal fixes for confirmed issues within scope, run the relevant checks, then start another blind review with a new subagent under

5.1k18d agoReads credentialsDiscuss
entireioCLAUDE.md

cli

entireio/cli/CLAUDE.md

Review architecture](docs/architecture/review-command.md) | | E2E tests | [E2E guide](e2e/README.md) | ## Verification | Task | Command / requirement | | --- | --- | | Unit tests | `mise run test` | | Integration tests | `mise run test:integration`; required when changing integration test code | | Deterministic

5.1k3mo agoDiscuss
clideyCLAUDE.md

whodb

clidey/whodb/CLAUDE.md

AGENTS.md ## Claude Code - Use plan mode for multi-file, risky, architectural, or ambiguous changes. - Use subagents only for bounded sidecar work: exploration, review, test triage, or documentation lookup. - Prefer separate

5k6d agoDiscuss
NateBJones-ProjectsCLAUDE.md

OB1

NateBJones-Projects/OB1/CLAUDE.md

License:** FSL-1.1-MIT. No commercial derivative works. Keep this in mind when generating code or suggesting dependencies. ## Repo Structure ``` extensions/ — Curated, ordered learning path (6 builds

4.6k7mo agoDeletes or force-pushesDiscuss
breferrariCLAUDE.md

obsidian-mind

breferrari/obsidian-mind/CLAUDE.md

self-heal guards; don't diagnose it. ### Custom Slash Commands Defined in `.claude/commands/`. Claude Code auto-surfaces every command with its description in the session's skills list — **that injected

4.6k45d agoDiscuss
SupabaseCLAUDE.md

supabase-js

supabase/supabase-js/.claude/CLAUDE.md

interactive commit tool:** ```bash pnpm commit ``` ### PR Requirements - ✅ At least 1 approving review from a code owner - ✅ All status checks passing (CI/CD pipeline) - ✅ No merge conflicts with the base branch

4.6k6mo agoDeletes or force-pushesDiscuss
PydanticCLAUDE.md

logfire

pydantic/logfire/CLAUDE.md

here; verify each finding against this repository's code, configuration and history before acting on it. Do not assume a reviewer is right, and do not assume it is wrong

4.5k44d agoDiscuss
vijaythecoderCLAUDE.md

awesome-claude-agents

vijaythecoder/awesome-claude-agents/CLAUDE.md

Agents for This Project - project-analyst - database-architect - django-backend-expert - django-api-developer - code-reviewer ## CRITICAL INSTRUCTION Use ONLY the agents listed above. Do NOT use laravel, rails

4.4k14mo agoDiscuss
IvanMurzakCLAUDE.md

Unity-MCP

IvanMurzak/Unity-MCP/CLAUDE.md

principles and architecture constraints: [`.specify/memory/constitution.md`](.specify/memory/constitution.md). You MUST read the constitution before performing any code review. ## Find Detail In - [docs/claude/architecture.md](docs/claude/architecture.md) — System architecture: SignalR bridge, main-thread execution, deterministic port

4.3k7mo agoDiscuss
JimLiuCLAUDE.md

baoyu-design / references

JimLiu/baoyu-design/skills/baoyu-design/references/claude.md

Claude Code. Substitute as follows everywhere — prose and code alike: | Web tool | Claude Code equivalent | |---|---| | `questions_v2` | `AskUserQuestion` (returns answers inline; up to 4 questions/call, follow-up call if more

4.2k3mo agoDiscuss
txn2CLAUDE.md

kubefwd

txn2/kubefwd/CLAUDE.md

Limitation UDP port forwarding is not supported (Kubernetes API limitation: kubernetes/kubernetes#47862). ## Code Organization ``` cmd/kubefwd/ # CLI entry point kubefwd.go # Main entry, root command services/ services.go # Services subcommand, namespace watchers

4.2k9mo agoDiscuss
nyldnCLAUDE.md

claude-octopus

nyldn/claude-octopus/CLAUDE.md

Review workflow:** ``` 🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider validation mode ✅ Deliver Phase: Reviewing authentication implementation Providers: 🔴 Codex CLI - Code quality analysis 🧭 Antigravity CLI - Security and edge cases 🔵 Claude - Synthesis and recommendations

4.1k48d agoReads credentialsDiscuss
bethingtonCLAUDE.md

ghidra-mcp

bethington/ghidra-mcp/CLAUDE.md

never post a claim about someone else's work without verifying it against the code first. - When Ben asks for a reply to a contributor, produce a short draft

4k7d agoReads credentialsDiscuss
AnthropicCLAUDE.md

anthropic-sdk-python

anthropics/anthropic-sdk-python/CLAUDE.md

contributors (human or AI) on how this SDK is put together, plus the things reviews most often come back to. Setup instructions live in [CONTRIBUTING.md](CONTRIBUTING.md). ## Overview The official Python

3.9k12d agoDiscuss
gadievronCLAUDE.md

raptor

gadievron/raptor/CLAUDE.md

same `--out` directory so `context-map.json`, `checklist.json`, and `flow-trace-*.json` are shared automatically. --- ## SYSTEMATIC CODE REVIEW The `/audit` command runs a hypothesis-driven code audit with tool verification

3.8k7d agoDiscuss
xintaofeiCLAUDE.md

codeg

xintaofei/codeg/CLAUDE.md

when working with code in this repository. ## 项目概述 Codeg(Code Generation)是一个多智能体编码工作台,它将多个智能体(Claude Code、Codex CLI、OpenCode、Gemini CLI、OpenClaw、Cline 等)统一到一个工作区中,支持会话聚合和多智能体协作,支持桌面安装,服务器/Docker 部署。 ## 技术栈

3.7k8d agoDiscuss
skyhook-ioCLAUDE.md

radar

skyhook-io/radar/CLAUDE.md

Before calling a UI feature done — consider visual-test.** `make tsc` + `make test` check code; `/visual-test` checks the *screen*. Run it yourself for self-contained UI changes where

3.5k36d agoReads credentialsDiscuss
AWSCLAUDE.md

agentcore-samples / claude-code

awslabs/agentcore-samples/01-features/02-host-your-agent/01-runtime/04-coding-agents/03-code-agents-competition-e2e/coding_agents/claude-code/CLAUDE.md

human review. - NEVER close an issue. Leave issues open for the reviewer. - Always add the label `agent:claude-code` to every issue and PR you touch. - Always add labels

3.4k4mo agoDiscuss
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.