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

VercelCLAUDE.md

ai-elements

vercel/ai-elements/.claude/CLAUDE.md

Prefer simple conditionals over nested ternary operators - Group related code together and separate concerns ### Security - Add `rel="noopener"` when using `target="_blank"` on links - Avoid `dangerouslySetInnerHTML` unless absolutely necessary

2.4k8mo agoDiscuss

InfisicalCLAUDE.md

agent-vault

Infisical/agent-vault/CLAUDE.md

passwordless mode), the DEK is stored in plaintext — suitable for PaaS deploys where volume security is the trust boundary. Login uses email+password. The first user to register becomes

2.3k6mo agoReads credentialsDiscuss

agno-agiCLAUDE.md

dash

agno-agi/dash/CLAUDE.md

2.3k6mo agoReads credentialsDiscuss

muxy-appCLAUDE.md

muxy

muxy-app/muxy/CLAUDE.md

user explicitly asks. Test processes use isolated Application Support storage. ## Top Level Rules - Security first - Maintainability - Scalability - Clean Code - Clean Architecture - Best Practices - No Hacky Solutions - Do not present assumptions

2.3k6mo agoDiscuss

StripeCLAUDE.md

stripe-cli

stripe/stripe-cli/CLAUDE.md

rather than `/tmp` — `bin/` is gitignored and within the project's trusted directory. macOS security may block execution of binaries built outside the project tree. ## Project Structure - `cmd/stripe/main.go` - Entry point

2.2k4mo agoDiscuss

AgriciDanielCLAUDE.md

claude-blog

AgriciDaniel/claude-blog/CLAUDE.md

hardening) blog-translator.md # Multilingual translation (no Bash, v1.7.0) tests/ # 250+ pytest checks incl. delivery-contract + security suites ``` ## Commands | Command | Purpose | |---------|---------| | `/blog write` | Write new articles optimized for rankings + AI citations | | `/blog

2.1k2mo agoDiscuss

ShopifyCLAUDE.md

hydrogen

Shopify/hydrogen/CLAUDE.md

Manually update skeleton's CLI version and release another cli-hydrogen cycle - **No** → Done ## Security concerns All content inside of `secrets.ejson` is sensitive and must NEVER be exposed. We have

2.1k6mo agoDiscuss

LumiwealthCLAUDE.md

lumibot

Lumiwealth/lumibot/CLAUDE.md

behavior description ### Fixed - Bug fix description ### Deprecated - Feature being phased out ### Removed - Removed feature ### Security - Security-related changes ``` ### Pre-Deployment Checklist Before any deployment: - [ ] Reviewed git commits since last version

2.1k18d agoReads credentialsDiscuss

MicrosoftCLAUDE.md

PowerApps-Samples

microsoft/PowerApps-Samples/CLAUDE.md

ImageOperations**: Image column handling - **Schema**: Metadata operations, entity creation - **Search**: Dataverse search, elastic search - **Security**: Role management, sharing, field security - **ServiceClient**: Modern client usage patterns - **Solutions**: Solution management and deployment

2k9mo agoDiscuss

doobidooCLAUDE.md

mcp-memory-service

doobidoo/mcp-memory-service/CLAUDE.md

README. ## Development Guidelines ### Quality gates Three layers: pre-commit (under 5s, Groq/Gemini complexity plus security, blocks on complexity above 8 or a security finding), the PR gate `bash scripts/pr/pre_pr_check.sh

2k5d agoReads credentialsDiscuss

WorldFlowAICLAUDE.md

everything-claude-code / examples

WorldFlowAI/everything-claude-code/examples/CLAUDE.md

Unit tests for utilities - Integration tests for APIs - E2E tests for critical flows ### 4. Security - No hardcoded secrets - Environment variables for sensitive data - Validate all user inputs - Parameterized queries only

2k9mo agoReads credentialsDiscuss

eneskircaCLAUDE.md

nodeterm

eneskirca/nodeterm/CLAUDE.md

# CLAUDE.md This is the deep-reference for working in this repo: the invariants, why

1.9k7d agoReads credentialsDiscuss

vstorm-coCLAUDE.md

full-stack-ai-agent-template

vstorm-co/full-stack-ai-agent-template/CLAUDE.md

backend/ │ ├── app/ │ │ ├── main.py # FastAPI app with lifespan │ │ ├── api/ # Routes, deps, exception handlers │ │ ├── core/ # Config, security, middleware │ │ ├── db/ # Models, session management │ │ ├── schemas/ # Pydantic request/response models │ │ ├── repositories/ # Data access layer │ │ ├── services/ # Business

1.9k6mo agoDiscuss

zzetCLAUDE.md

gortex

zzet/gortex/CLAUDE.md

runs structural tree-sitter queries; `analyze kind=sast` is a 190-rule, CWE/OWASP-tagged security scan across 8 languages. - **Push notifications** — beyond `notifications/diagnostics`, the server pushes `graph_invalidated` (graph hot-reload

1.8k6mo agoReads credentialsDiscuss

SupabaseCLAUDE.md

postgres

supabase/postgres/CLAUDE.md

flight features (profiler, pgbackrest, etc.) | | `.claude/skills/pg-security-release-analysis/` | Skill for triaging upstream PG quarterly security releases into a CVE/impact catalog — see below | ## Building and testing Exact commands verified against `nix/docs/build-postgres.md`, `nix/docs/development-workflow.md

1.8k4mo agoDiscuss

relaticleCLAUDE.md

relaticle

relaticle/relaticle/CLAUDE.md

=== .ai/relaticle/architecture rules === # Architecture Relaticle is a modular monolith: the CRM core lives in `app

1.7k6d agoReads credentialsDiscuss

lst97CLAUDE.md

claude-code-sub-agents

lst97/claude-code-sub-agents/CLAUDE.md

tests for new logic, both UI and API. **Before committing:** - Run formatter, linter, and security scans. - Ensure commit messages explain *why*, not just *what*. ### Error Handling - Fail fast with descriptive

1.7k14mo agoDiscuss

LynpointCLAUDE.md

CyberVerse

Lynpoint/CyberVerse/claude.md

real root cause. - Reject fixes that only patch symptoms. - Reject changes that damage architecture, security, performance, maintainability, or type safety. - Prefer minimal correct fixes over large unnecessary rewrites. - Explain

1.6k4mo agoDiscuss

patrickchughCLAUDE.md

terravision

patrickchugh/terravision/docs/CLAUDE.md

that converts Terraform code into professional cloud architecture diagrams. It runs 100% client-side, securely parses Terraform plans, and generates visual representations of cloud infrastructure without requiring access to cloud

1.6k5d agoReads credentialsDiscuss

ddalcuCLAUDE.md

mlx-serve / app

ddalcu/mlx-serve/app/CLAUDE.md

# Swift macOS app (MLX Core) — AI context Compressed rules. Full war stories: `../docs/gotchas/app.md`. Full

1.6k3d agoReads credentialsDiscuss

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.