CLAUDE.md examples from real projects

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

Best matchesWorked for most · soon

“frontend” Hiding risky files

LeeYudokCLAUDE.md

doksam-skills / agents

LeeYudok/doksam-skills/skills/frontend-build/agents/claude.md

pnpm 워크스페이스와 Vite 빌드를 설정·정비하거나, 의존성·락파일·번들 크기·폐쇄망 self-host 문제를 다룰 때 사용한다. 프레임워크 자체의 코드 작성이 아니라 빌드/패키징 층이 대상이다.

126d agoDiscuss

nextlevelbuilderCLAUDE.md

ui-ux-pro-max-skill / stack

nextlevelbuilder/ui-ux-pro-max-skill/stack/CLAUDE.md

source of truth for tokens (color, type, spacing). 2. **COMMIT to an aesthetic — `frontend-design`.** Do not sample the safe center of the training distribution. Answer four questions first — *purpose

131k3d agoDiscuss

addyosmaniCLAUDE.md

agent-skills

addyosmani/agent-skills/CLAUDE.md

Build:** incremental-implementation, test-driven-development, context-engineering, source-driven-development, doubt-driven-development, frontend-ui-engineering, api-and-interface-design **Verify:** browser-testing-with-devtools, debugging-and-error-recovery

100k5d agoDiscuss

bytedanceCLAUDE.md

deer-flow / frontend

bytedance/deer-flow/frontend/CLAUDE.md

CLAUDE.md The frontend agent guidance lives in [AGENTS.md](AGENTS.md) so it is shared across coding agents (Claude Code, Codex, and others). Claude Code imports it below. @AGENTS.md

83k3mo agoDiscuss

AnthropicCLAUDE.md

claude-cookbooks / chief_of_staff_agent

anthropics/claude-cookbooks/claude_agent_sdk/chief_of_staff_agent/CLAUDE.md

Revenue per Employee**: $48K ## Team Structure - **Total Headcount**: 50 - **Engineering**: 25 (50%) - Backend: 12 - Frontend: 8 - DevOps/SRE: 5 - **Sales & Marketing**: 12 (24%) - **Product**: 5 (10%) - **Operations**: 5 (10%) - **Executive

53k8mo agoDiscuss

CherryHQCLAUDE.md

cherry-studio

CherryHQ/cherry-studio/CLAUDE.md

wide purge is its own task, not a side effect of an unrelated PR. - **Frontend Tests — MUST READ**: [Frontend Testing Guidelines](docs/references/testing/frontend-testing.md). - **Test Mocking**: Use the unified mock system

52k42d agoDiscuss

QuantumNousCLAUDE.md

new-api

QuantumNous/new-api/CLAUDE.md

rest of the work. - If the task touches `web/`, also Read `web/AGENTS.md` before editing frontend files. - If the task touches billing as defined under **Billing rules (mandatory read gate

49k13d agoDiscuss

danny-avilaCLAUDE.md

LibreChat

danny-avila/LibreChat/CLAUDE.md

45k49d agoDiscuss

chroma-coreCLAUDE.md

chroma

chroma-core/chroma/CLAUDE.md

local services are ready. In this repo, the key readiness signals are: - frontend healthcheck responds on `http://localhost:8000/api/v2/healthcheck` - Spanner emulator is reachable on `localhost:9010` - required Kubernetes pods

29k3y agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / agents

alirezarezvani/claude-skills/agents/CLAUDE.md

builder. Invokable via `/cs:fullstack-review` or `Agent({subagent_type:"cs-fullstack-engineer"})`. | | [cs-frontend-engineer](engineering/cs-frontend-engineer.md) | Engineering | Frontend orchestrator (v2.8.1): walks 7 forcing questions (device, LCP target, rendering, bundle

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / engineering-team

alirezarezvani/claude-skills/engineering-team/CLAUDE.md

their Python automation tools. ## Engineering Skills Overview **Core Engineering (16 skills):** - senior-architect, senior-frontend, senior-backend, senior-fullstack - senior-qa, senior-devops, senior-secops - code-reviewer, senior-security

25k5mo agoDiscuss

VoltAgentCLAUDE.md

awesome-claude-code-subagents

VoltAgent/awesome-claude-code-subagents/CLAUDE.md

that Claude Code can load and use. ## Repository Structure ``` categories/ 01-core-development/ # Backend, frontend, fullstack, mobile, etc. 02-language-specialists/ # Language/framework experts (TypeScript, Python, etc.) 03-infrastructure/ # DevOps, cloud

25k7mo agoDiscuss

open-metadataCLAUDE.md

OpenMetadata

open-metadata/OpenMetadata/CLAUDE.md

discovery, observability, and governance — a multi-module project with a Java backend, a React/TypeScript frontend, a Python ingestion framework, and Docker infrastructure. ## Stack at a glance - **Backend**: Java 21 + Dropwizard

15k29d agoDiscuss

Untrivial-aiCLAUDE.md

agent-orchestrator

Untrivial-ai/agent-orchestrator/CLAUDE.md

agent-orchestrator** — do **not** re-flag old design-reference mismatches. When showing or demoing frontend changes, run `ao preview [url]` from inside the session so the change renders

12k14d agoDiscuss

MemTensorCLAUDE.md

MemOS

MemTensor/MemOS/CLAUDE.md

integration / end-to-end cases under `tests/` | The main repo has no frontend stack, so no `frontend-dev` is provided; TypeScript sub-projects under `apps/` use their own AI configuration

12k4mo agoDiscuss

0xJackyCLAUDE.md

nginx-ui

0xJacky/nginx-ui/CLAUDE.md

project is a web-based NGINX management interface built with Go backend and Vue.js frontend. ## Package Manager - **Use Bun exclusively** for all frontend package management operations - Commands: `bun install

12k11d agoDiscuss

humanlayerCLAUDE.md

humanlayer / humanlayer-wui

humanlayer/humanlayer/humanlayer-wui/CLAUDE.md

/.config/dev.humanlayer.wui/logs/` Logs include output from the WUI backend, daemon stderr (prefixed with [Daemon]), and frontend console logs (prefixed with [Console]). The log files automatically rotate at 50MB. The application

11k12mo agoDiscuss

JeffallanCLAUDE.md

claude-skills

Jeffallan/claude-skills/CLAUDE.md

conditions] - max 1024 chars license: MIT metadata: author: https://github.com/Jeffallan version: "1.0.0" domain: frontend triggers: keyword1, keyword2, keyword3 role: specialist scope: implementation output-format: code related-skills: fullstack-guardian

11k9mo agoDiscuss

airweave-aiCLAUDE.md

airweave

airweave-ai/airweave/CLAUDE.md

Architecture Monorepo with four main components: - **Backend** (`backend/`): Python 3.13, FastAPI, SQLAlchemy async, PostgreSQL - **Frontend** (`frontend/`): React 18, TypeScript, Vite, ShadCN UI, TailwindCSS - **Workers**: Temporal for async sync orchestration, Redis

6.6k6mo agoDiscuss

ZSeven-WCLAUDE.md

openpencil / crates

ZSeven-W/openpencil/crates/CLAUDE.md

byte-identical. Assets are served from `/pkg/assets/…` (**not** `/assets/`, which belongs to the hub frontend) and staged into the bundle by `tools/stage-web-assets.sh`, which `check-wasm-bundle.sh` runs as step 4 and both

6k2mo 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.