agentleFS
Sign inStart free

CLAUDE.md examples from real projects

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

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Worked for most · soon
DogaOztuzun remove filter
DogaOztuzunCLAUDE.md

branchdeck

DogaOztuzun/branchdeck/CLAUDE.md

Guidance for Claude Code when working in this repository. Branchdeck is a daemon-first autonomous development system — desktop-delivered, local-first. Detects quality issues, implements fixes, verifies improvements, learns from results. Stack: Tauri v2 (Rust) + SolidJS (TypeScript) + xterm.js (terminal) + Axum (daemon) Crate boundary rule: use axum:: → daemon. use tauri:: → desktop. Everything else → core. See @.claude/rules/crate-boundaries.md for details. See @.claude/rules/testing.md for full testing patterns and effect executor rules. Quick reference: - Pure functions first, return effects, no…

187mo agoReviewMountCreate a free account to mount
DogaOztuzunCLAUDE.md

branchdeck / src

DogaOztuzun/branchdeck/src/CLAUDE.md

Shared frontend for desktop and web modes. Connects to daemon via HTTP/SSE. Always read @DESIGN.md before visual/UI work. Highlights: - 0px border-radius on all containers (2px for inline hover only) - No spinners — pulsing opacity (0.4→1.0, 2s) for loading - No modals for primary actions — one click, not two - Inline error text in error color — never toast/modal - Monospace characters as icons (>_ for agent, 8x8 squares for status)

187mo 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.