agentleFS

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 4Worked for most · soon
getpaseoCLAUDE.md

paseo

getpaseo/paseo/CLAUDE.md

docs/docker.md](docs/docker.md) | Running the daemon and bundled web UI in Docker, volumes, agent images, security | | [docs/release.md](docs/release.md) | Release playbook, draft releases, completion checklist | | [docs/terminal-worker.md](docs/terminal-worker.md) | Terminal worker process model, socket/record/secret

Steady22 mentions in 2 weeks

No other project uses it yet

23k3mo agoReviewMountCreate a free account to mount
microCLAUDE.md

go-micro

micro/go-micro/CLAUDE.md

Patterns for agent-friendly error responses - **Documentation Guides** - Six guides: AI-native services, MCP security, tool descriptions, agent patterns, error handling, troubleshooting - **WithMCP Option** - One-line MCP setup (`gateway/mcp/option.go`) - **Agent

No other project uses it yet

23k15d agoReviewMountCreate a free account to mount
QwikDevCLAUDE.md

qwik

QwikDev/qwik/CLAUDE.md

unit.ts(x)` | Vitest unit files | | `*.spec.ts(x)` | Vitest spec files | | `*.e2e.ts` | Playwright e2e files | ### Security And Supply Chain Treat security-sensitive changes as behavior changes even when they look like

No other project uses it yet

22k25d agoReviewMountCreate a free account to mount
eclipse-theiaCLAUDE.md

theia

eclipse-theia/theia/CLAUDE.md

issues, and comments **brief and concise** — no padding, marketing language, or restating the diff. - **Security:** never disclose vulnerabilities via a GitHub issue or PR — report them per `SECURITY.md`. Such issues

No other project uses it yet

22k14d agoReviewMountCreate a free account to mount
onnxCLAUDE.md

onnx

onnx/onnx/CLAUDE.md

tooling) are fine as a normal public issue or PR, but a non-trivial security vulnerability must be reported privately via GitHub Security Advisories, not a public issue. ## Project Norms

No other project uses it yet

22k12d agoReviewMountCreate a free account to mount
wekanCLAUDE.md

wekan

wekan/wekan/CLAUDE.md

pull request ITSELF is the participant, and is named.** GitHub CodeQL filing a security fix, Copilot Autofix, Dependabot raising a dependency bump: nobody wrote those, so crediting a human would

No other project uses it yet

21k33d agoReviewMountCreate a free account to mount
bitwardenCLAUDE.md

server

bitwarden/server/.claude/CLAUDE.md

passwords, keys, or vault data in logs or error messages - **ALWAYS** use secure communication channels: Enforce confidentiality, integrity, and authenticity - **ALWAYS** encrypt sensitive data: All vault data must be encrypted

No other project uses it yet

21k4mo agoReviewMountCreate a free account to mount
AgriciDanielReads credentialsCLAUDE.md

claude-seo

AgriciDaniel/claude-seo/CLAUDE.md

Image gen reference files (7 files) agents/ # 19 subagents (auto-discovered) seo-technical.md # Crawlability, indexability, security seo-content.md # E-E-A-T, readability, thin content seo-schema.md # Structured data validation seo-sitemap.md # Sitemap quality

Steady4 mentions in 2 weeks

No other project uses it yet

20k5mo agoReviewMountCreate a free account to mount
AnthropicReads credentialsCLAUDE.md

claude-quickstarts / self-hosted-sandboxes

anthropics/claude-quickstarts/managed-agents/self-hosted-sandboxes/CLAUDE.md

demo working. `make status` and `state/ledger.jsonl` show every decision. On a Mac where endpoint security blocks OpenShell's binaries, the README's "Running the gateway in Docker" runs the gateway

Steady5 mentions in 2 weeks

No other project uses it yet

19k51d agoReviewMountCreate a free account to mount
ahmedkhaleel2004Reads credentialsCLAUDE.md

gitdiagram

ahmedkhaleel2004/gitdiagram/CLAUDE.md

cookie) and per connection, in Redis, failing closed. These are access rules, not a security boundary (a VPN passes). Only the operator may regenerate an existing video. - **Paid videos** (`payments.ts

No other project uses it yet

19k22d agoReviewMountCreate a free account to mount
gnachmanCLAUDE.md

iTerm2 / WebExtensionsFramework

gnachman/iTerm2/WebExtensionsFramework/CLAUDE.md

what code needs to be on the main actor * Think carefully about edge cases * Security is paramount. The web is a hostile platform and we must be very careful

No other project uses it yet

18k56d agoReviewMountCreate a free account to mount
nodemailerCLAUDE.md

nodemailer

nodemailer/nodemailer/CLAUDE.md

src/mime-node/` - message -> MIME tree -> raw RFC822 stream. - `src/smtp-connection/` - low-level SMTP/LMTP/ESMTP client. Hot path; security-sensitive. Used by `smtp-transport` and `smtp-pool`. - `src/smtp-transport/` - single-shot SMTP transport. - `src/smtp-pool/` - pooled

No other project uses it yet

18k13mo agoReviewMountCreate a free account to mount
questdbCLAUDE.md

questdb

questdb/questdb/CLAUDE.md

Enhancement`, `Flaky Test`, `ILP`, `Materialized View`, `New feature`, `Performance`, `Postgres Wire`, `REST API`, `SQL`, `Security`, `UI`, `WAL`, `Windows`, `regression`, `rust`, `storage`. - Use active voice in commit messages, PR descriptions

No other project uses it yet

18k7d agoReviewMountCreate a free account to mount
joewalnesCLAUDE.md

websocketd

joewalnes/websocketd/CLAUDE.md

docs-archive/`. ## Changelog Update `CHANGES` before committing if the change affects: - Dependencies (especially security fixes) - User-visible behavior, CLI flags, or defaults - New features or test infrastructure - Bug fixes referenced

No other project uses it yet

17k2mo agoReviewMountCreate a free account to mount
javascript-obfuscatorCLAUDE.md

javascript-obfuscator

javascript-obfuscator/javascript-obfuscator/CLAUDE.md

# JavaScript Obfuscator - Project Documentation ## Project Overview **JavaScript Obfuscator** is a powerful, enterprise-grade code

Steady4 mentions in 2 weeks

No other project uses it yet

16k11mo agoReviewMountCreate a free account to mount
GreyDGLCLAUDE.md

PentestGPT

GreyDGL/PentestGPT/CLAUDE.md

Runtime contract - The Supervisor and Executor both use `SandboxPolicy.FULL_ACCESS`; deployment isolation is the security boundary. - Each episode is fresh. SQLite and exact trace receipts—not provider conversation history

No other project uses it yet

16k4mo agoReviewMountCreate a free account to mount
saltstackCLAUDE.md

salt / agents

saltstack/salt/agents/CLAUDE.md

options (test mode, minion ID, etc.) - `__grains__` - System information (OS, platform, custom data) - `__pillar__` - Secure data for this minion - `__context__` - Per-run cache (persists during Salt execution) **Module-Specific:** - `__salt

No other project uses it yet

16k4mo agoReviewMountCreate a free account to mount
mauriceboeReads credentialsCLAUDE.md

NOMAD

mauriceboe/NOMAD/CLAUDE.md

subsystems (providers, pipes, guards, `@nestjs/schedule`) over hand-rolled equivalents. - **Fail closed, gates stay on.** Security switches default to safe; misconfiguration must refuse, not degrade. Never lower a quality gate

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
mauriceboeCLAUDE.md

NOMAD / client

mauriceboe/NOMAD/client/CLAUDE.md

isEffectivelyOffline()` is the single source of truth — never read `navigator.onLine` in feature code. - **Rendering security**: never interpolate user content into HTML strings (map popups included — build via DOM + `textContent

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
mauriceboeCLAUDE.md

NOMAD / plugin-sdk

mauriceboe/NOMAD/plugin-sdk/CLAUDE.md

plugin's `client/index.html` (the opaque-origin iframe CSP forbids external link/script). Not a security boundary. - **`src/lucide-icon-names.ts`** — generated snapshot; an unknown icon is a validate **warning**, never an error. - **`test/helpers.ts`** — `makePublishable

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
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.