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 5Worked for most · soon

869413421CLAUDE.md

ai-moive-studio

869413421/ai-moive-studio/CLAUDE.md

head # 数据库迁移 uvicorn src.main:app --reload --host 0.0.0.0 --port 8000 # 开发服务器 ``` ### 前端开发 ```bash cd frontend npm install # 安装依赖 npm run dev # 开发服务器（默认端口3000，会自动检测占用） ``` ### 服务地址 - API文档: http://localhost:8000/docs - MinIO控制台

1.5k10mo agoReads credentialsDiscuss

Open-Source-LegalCLAUDE.md

OpenContracts

Open-Source-Legal/OpenContracts/CLAUDE.md

text-based formats. It features a Django/GraphQL backend with PostgreSQL + pgvector, a React/TypeScript frontend with Jotai state management, and pluggable document processing pipelines powered by machine learning models. ## Baseline Commit

1.5k12mo agoDiscuss

Open-Source-LegalCLAUDE.md

OpenContracts / frontend

Open-Source-Legal/OpenContracts/frontend/Claude.md

Frontend Design Language ## Design Philosophy The design system emphasizes clarity, depth, and delight through subtle animations and thoughtful visual hierarchy. ## Core Design Principles ### 1. Visual Hierarchy Through Depth - **Layered Cards

1.5k12mo agoDiscuss

JwuthriCLAUDE.md

Tracely-ai

Jwuthri/Tracely-ai/CLAUDE.md

hand-authored datasets. A `uv` workspace (`backend`, `workers`, `sdk`) plus a pnpm Next.js app (`frontend`) and a Nextra docs site (`docs`). ## Commands ```bash make install # uv sync --all-packages

1.4k2mo agoReads credentialsDiscuss

Team-CommonlyCLAUDE.md

commonly

Team-Commonly/commonly/CLAUDE.md

Agent Hub UX, install confirmation, first-message coaching | The 60-second value prop | | 🟢 **Marketplace frontend** | Mid-queue (backend already shipped: PR #215 + #230, `/api/marketplace/*` 9 endpoints) | Browse page, manifest detail

1.4k3mo agoReads credentialsDiscuss

first-flukeCLAUDE.md

oh-my-agent

first-fluke/oh-my-agent/CLAUDE.md

prisma} | | debug | `.agents/rules/debug.md` | on request | | design | `.agents/rules/design.md` | on request | | dev-workflow | `.agents/rules/dev-workflow.md` | on request | | frontend | `.agents/rules/frontend.md` | **/*.{tsx,jsx,css,scss} | | i18n-arb | `.agents/rules/i18n-arb.md` | **/*.arb | | i18n-guide | `.agents/rules/i18n-guide.md` | always | | infrastructure | `.agents/rules/infrastructure.md

1.3k7d agoDiscuss

sipyourdrink-ltdCLAUDE.md

bernstein

sipyourdrink-ltd/bernstein/CLAUDE.md

write to them manually. - `adversary` - `analyst` - `architect` - `backend` - `ci-fixer` - `devops` - `docs` - `frontend` - `manager` - `ml-engineer` - `prompt-engineer` - `qa` - `resolver` - `retrieval` - `reviewer` - `security` - `visionary` - `vp` ## Documentation duty Every PR that

1.3k9d agoDiscuss

dohoooCLAUDE.md

helmor

dohooo/helmor/CLAUDE.md

with perf HUD (VITE_HELMOR_PERF_HUD=1) bun run build # tsc + vite build (frontend bundle to dist/) bun run typecheck # tsc --noEmit for frontend AND sidecar bun run lint

1.3k3mo agoDiscuss

d-kimusonCLAUDE.md

claude-code-viewer

d-kimuson/claude-code-viewer/CLAUDE.md

based client built as a CLI tool serving a Vite application. **Core Architecture**: - Frontend: Vite + TanStack Router + React 19 + TanStack Query - Backend: Hono (standalone server) + Effect-TS (all business logic

1.3k5mo agoDiscuss

Chorus-AIDLCCLAUDE.md

Chorus

Chorus-AIDLC/Chorus/CLAUDE.md

Stack - **Framework**: Next.js 15 (App Router, Turbopack for dev) - **Language**: TypeScript 5 (strict mode) - **Frontend**: React 19, Tailwind CSS 4, shadcn/ui (Radix UI) - **Database**: PostgreSQL 16, Prisma ORM 7 - **Cache/Pub-Sub

1.2k5mo agoDiscuss

sheshbabuCLAUDE.md

zen

sheshbabu/zen/CLAUDE.md

repository. Zen is a self-hosted notes app: Go backend with SQLite (FTS5), Preact frontend bundled by esbuild. ## Core rules (always apply) - Keep code simple and readable; prefer the smallest

1.2k5d agoDiscuss

fcakyonCLAUDE.md

claude-codex-settings

fcakyon/claude-codex-settings/.claude/CLAUDE.md

site-architecture`, `programmatic-seo`, or `schema` skill based on the task. - Use the `anthropic-frontend-design` or `openai-frontend-design` skill when creating or reshaping a UI. ## MCP Tools ### Tavily

1.2k22d agoDiscuss

vm0-aiCLAUDE.md

vm0

vm0-ai/vm0/CLAUDE.md

endpoints belong in `turbo/apps/api` (Hono, `src/signals/routes/`). Browser clients call the canonical API service. Frontend apps must not add API handlers or thin proxy handlers. If a frontend origin must expose

1.2k6mo agoDiscuss

RchGravCLAUDE.md

claudebox / claude

RchGrav/claudebox/claude/CLAUDE.md

split PRs:** - **Multiple unrelated behaviors** (authentication vs database vs caching) - **Different deployment boundaries** (frontend vs backend in systems with separate deployment pipelines) - **Refactoring separate from new features** (clean up existing

1.2k15d agoDiscuss

KroMioseCLAUDE.md

nekro-agent

KroMiose/nekro-agent/CLAUDE.md

同步含开发依赖（uv sync --all-extras） | 注意: 如果遇到权限问题，请使用 `sudo` 命令。 ### 前端（TypeScript/React）— 使用 `poe frontend-*` 或 `pnpm`（在 `frontend/` 目录下） | 命令 | 说明 | | ------------------------- | ----------------------------------------------------------------- | | `poe frontend-check` | **全量检查**：typecheck + eslint（0 warnings

1.1k6mo agoDiscuss

AltanSCLAUDE.md

collie

AltanS/collie/CLAUDE.md

herdr plugin install`, the operator's only other way to refresh ([ADR 0006](./.adr/0006-update-advances-the-checkout-herdr-installed.md)). - **Frontend changes** (`web/`): rebuild with `bun run build` (root) or `cd web && bun run build

1.1k43d agoDiscuss

manaflow-aiCLAUDE.md

manaflow

manaflow-ai/manaflow/CLAUDE.md

exist, but you can still run the script if `echo $MORPH_API_KEY` works. # Frontend This project uses React, TanStack Router, TanStack Query, Shadcn UI, and Tailwind CSS. Always

1.1k10mo agoReads credentialsDiscuss

dtsolaCLAUDE.md

xiaoyaosearch

dtsola/xiaoyaosearch/.claude/CLAUDE.md

requirements.txt .\venv\Scripts\python.exe main.py ``` 验证：http://127.0.0.1:8000/docs ### 前端启动（Electron + Vue3） ```powershell cd frontend npm install npm run electron:dev ``` ### 高保真原型 ```powershell cd docs\高保真原型\v1.0

1.1k5mo agoReads credentialsDiscuss

weieskyCLAUDE.md

cc-viewer

weiesky/cc-viewer/CLAUDE.md

prohibited. New interactive controls must come with the matching i18n entries: `apps/web/src/i18n.js` (frontend) or `packages/app/server/i18n.js` (server/CLI) — adding them to the wrong file is prohibited. After any code change, `pnpm

1.1k12d agoDiscuss

yuanchengluCLAUDE.md

claude-code-webui

yuanchenglu/claude-code-webui/CLAUDE.md

ongoing requests - `GET /api/projects/:encodedProjectName/histories` - Conversation histories - `GET /api/projects/:encodedProjectName/histories/:sessionId` - Specific conversation history ### Frontend (React) - **Location**: `frontend/` | **Port**: 3000 (configurable) - **Technology**: Vite + React + SWC + TypeScript + TailwindCSS + React Router - **Purpose

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