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

NateBJones-ProjectsCLAUDE.md

OB1

NateBJones-Projects/OB1/CLAUDE.md

recipes/ — Standalone capability builds. Open for community contributions. schemas/ — Database table extensions. Open. dashboards/ — Frontend templates (Vercel/Netlify). Open. integrations/ — MCP extensions, webhooks, capture sources. Open. skills/ — Reusable AI client skills

4.6k7mo agoDeletes or force-pushesDiscuss

macro-incCLAUDE.md

macro

macro-inc/macro/CLAUDE.md

Macro is a document and collaboration app with a Rust backend and a web frontend. This file is the shared entry point: `AGENTS.md` symlinks to `CLAUDE.md`. Edit `CLAUDE.md` and preserve

4.5k14d agoDiscuss

vijaythecoderCLAUDE.md

awesome-claude-agents

vijaythecoder/awesome-claude-agents/CLAUDE.md

agents support all technology stacks 3. **Universal Agents** (`agents/universal/`) - Framework-agnostic specialists (API, backend, frontend, Tailwind) - Fallback when no framework-specific agent exists 4. **Specialized Agents** (`agents/specialized/`) - Framework-specific experts

4.4k14mo agoDiscuss

kirodotdevCLAUDE.md

KiroCrew

kirodotdev/KiroCrew/CLAUDE.md

guidance of its own — do not add rules here, add them to `AGENTS.md`. The frontend has its own `website/AGENTS.md`. @AGENTS.md

4.2k32d agoDiscuss

kirodotdevCLAUDE.md

KiroCrew / website

kirodotdev/KiroCrew/website/CLAUDE.md

CLAUDE.md — Kiro Crew dashboard (frontend) **`website/AGENTS.md` is the single source of truth for frontend work in `website/`.** Read it before any UI change; it is imported below

4.2k32d agoDiscuss

melgarafaelCLAUDE.md

DeskcommCRM

melgarafael/DeskcommCRM/CLAUDE.md

tenant com RLS desde o dia 1; LGPD nativa. Posicionamento completo: `VISION.md`. --- ## Stack canônica - **Frontend:** Next.js 16 App Router (Turbopack) + React 19 + TypeScript 6 estrito + Tailwind 4 (config

4.2k13d agoReads credentialsDiscuss

bethingtonCLAUDE.md

ghidra-mcp

bethington/ghidra-mcp/CLAUDE.md

Annotation Scanner**: `AnnotationScanner.java` discovers `@McpTool` methods, generates `/mcp/schema` Services use constructor injection: `ProgramProvider` + `ThreadingStrategy`. - FrontEnd mode: `FrontEndProgramProvider` + `DirectThreadingStrategy` - Headless mode: `HeadlessProgramProvider` + `DirectThreadingStrategy` ## Tool Inventory Do not try to keep

4k7d agoReads credentialsDiscuss

BenedictKingCLAUDE.md

ccx

BenedictKing/ccx/CLAUDE.md

注入运行时版本信息。 ## 常用命令 ```bash # 根目录（推荐） make dev # 同时启动前端开发服务器和后端热重载 make run # 构建前端并运行 Go 后端 make frontend-dev # 前端开发服务器 make build # 构建前端并编译 Go 后端 make clean # 清理构建文件 # Go 后端开发 (backend-go/) make

4k14d agoReads credentialsDiscuss

BenedictKingCLAUDE.md

ccx / desktop

BenedictKing/ccx/desktop/CLAUDE.md

目录执行： ```bash wails3 dev # 启动桌面开发模式 wails3 build # 构建桌面应用 ``` 桌面前端命令参考 [frontend/CLAUDE.md](frontend/CLAUDE.md)。 ## 目录说明 | 路径 | 职责 | |------|------| | `frontend/` | 桌面端 Vue 前端界面 | | `bindings/` | Wails 生成的前后端绑定 | | `internal/` | 桌面端 Go 服务实现 | ## 桌面前端包管理 `desktop/frontend/` 以 Bun 为主包管理器

4k14d agoReads credentialsDiscuss

BenedictKingCLAUDE.md

ccx / frontend

BenedictKing/ccx/frontend/CLAUDE.md

frontend 模块文档 [← 根目录](../CLAUDE.md) ## 模块职责 Vue 3 + Vuetify 3 Web 管理界面：渠道配置、能力测试、模型列表查询、拖拽排序、监控面板、主题切换。 ## 启动命令 ```bash bun run dev # 开发服务器 bun run build # 生产构建 bun run preview

4k14d agoDiscuss

glitternetworkCLAUDE.md

pinme

glitternetwork/pinme/CLAUDE.md

published to npm as `pinme`. Users run commands like `pinme upload dist` to deploy frontends. ## Build & Dev ```bash npm run build # Production build (esbuild → dist/index.js) npm run dev # Dev build

3.7k3mo agoReads credentialsDiscuss

skyhook-ioCLAUDE.md

radar

skyhook-io/radar/CLAUDE.md

caps `verdict.go`, parser `parse.go`, binder `bind.go`; OSS orchestration and ref eligibility stay in `internal/ai/runs.go`; frontend tokenizer `web/src/components/diagnose/investigationStory.ts`, story `AnalysisStory.tsx`, turn rule `investigationState.ts` (`investigationIsAssessmentTurn`) | | Writing or modifying **frontend UI / styling** | [DESIGN.md

3.5k36d agoReads credentialsDiscuss

RunMaestroCLAUDE.md

Maestro

RunMaestro/Maestro/CLAUDE.md

# CLAUDE.md Essential guidance for working with this codebase. For detailed architecture, see [ARCHITECTURE.md](ARCHITECTURE.md

3.4k50d agoDiscuss

stravuCLAUDE.md

crystal

stravu/crystal/CLAUDE.md

native OS integration - Custom ConfigManager for configuration persistence (~/.crystal/config.json) - IPC handlers for renderer communication ### Frontend (React 19 + TypeScript) - **Framework**: React 19 with TypeScript - **State Management**: Zustand for reactive state management

3.1k12mo agoDiscuss

Chachamaru127CLAUDE.md

claude-code-harness

Chachamaru127/claude-code-harness/CLAUDE.md

specific skill variants / `hooks/` Hooks / `scripts/` Shell scripts / `src/` TypeScript implementation / `app/` App layer / `frontend/` Frontend implementation / `docs/` Documentation / `templates/` Templates / `tests/` Validation / `go/` Harness v4 Go native engine ([SPEC.md

3.1k48d agoDeletes or force-pushesDiscuss

MaxMiksaCLAUDE.md

Auto-Company

MaxMiksa/Auto-Company/CLAUDE.md

Security - `code-review-security`, `security-audit`, `devops`, `tailwind-v4-shadcn` ### UX and Experience - `frontend-design`, `ux-audit-rethink`, `user-persona-creation`, `user-research-synthesis` ### Marketing and Growth - `seo-content-strategist

3.1k13mo agoReads credentialsDiscuss

compozyCLAUDE.md

compozy

compozy/compozy/CLAUDE.md

local full/E2E runs share a machine lock, so do not kill a queued run. - Frontend validation runs through Turborepo from the repo root, with affected-package filters during iteration. Package

2.8k6d agoDiscuss

compozyCLAUDE.md

compozy / web

compozy/compozy/web/CLAUDE.md

Frontend React SPA using Vite, TanStack Router/Query, Tailwind, shadcn/ui, XState Store, and Zod. Root `CLAUDE.md` owns compatibility and delivery; this file adds web conventions. ## Ownership and Contracts - Domain features live

2.8k6d agoDiscuss

AnthropicCLAUDE.md

claude-agent-sdk-demos / simple-chatapp

anthropics/claude-agent-sdk-demos/simple-chatapp/CLAUDE.md

Simple Chat App A minimal chat application demonstrating the Claude Agent SDK. ## Architecture - **Frontend**: React + Vite + Tailwind CSS - **Backend**: Node.js + Express + WebSocket (ws) - **Agent**: Claude Agent SDK integrated directly

2.8k13mo agoDiscuss

marketcallsCLAUDE.md

openalgo

marketcalls/openalgo/CLAUDE.md

repo. ## Overview OpenAlgo is a production algorithmic trading platform: Flask backend, React 19 frontend. It is **several products in one self-hosted instance**, all sharing a single broker session

2.7k8d 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.