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

hanlulongCLAUDE.md

openecon-data

hanlulong/openecon-data/CLAUDE.md

production on port 3001). For dev on another machine: ```bash python3 scripts/restart_dev.py # Both backend + frontend (dev) python3 scripts/restart_dev.py --status # Check running services ``` **NEVER** manually run `uvicorn`, `nohup`, or start services

776mo agoReads credentialsDiscuss

whiteboardmonkCLAUDE.md

agcluster-container

whiteboardmonk/agcluster-container/CLAUDE.md

validation, filename sanitization, path traversal protection 8. **Web UI** (`src/agcluster/container/ui/`) - Next.js 15 + React + TypeScript frontend - Real-time chat interface with AI SDK v5 - Agent configuration builder with preset templates - Session

7711mo agoReads credentialsDiscuss

9thLevelSoftwareCLAUDE.md

legion

9thLevelSoftware/legion/CLAUDE.md

summary files ``` ## Agent Divisions (49 total) | Division | Count | Focus | |----------|-------|-------| | Engineering | 9 | Full-stack, backend, frontend, AI, infrastructure/DevOps, mobile, prototyping, Laravel, security | | Design | 6 | UI/UX, branding, visual storytelling, research | | Marketing

765mo agoDiscuss

gurusupCLAUDE.md

claude-code-demo

gurusup/claude-code-demo/CLAUDE.md

implementations repositories/ # Repository implementations config/ # DependencyContainer (IoC) app/ api/conversations/ # Next.js API route (thin controller) ``` #### Frontend ``` app/ features/ # Feature-based organization for UI conversation/ components/ # React components hooks/ # Business hooks (useConversation

7612mo agoReads credentialsDiscuss

hang-inCLAUDE.md

tunaFlow

hang-in/tunaFlow/CLAUDE.md

Skills: vendor별 스킬 snapshot (`~/.tunaflow/skills/`) --- ## 2. 기술 스택 | 계층 | 기술 | |---|---| | Desktop shell | Tauri 2 | | Frontend | React 18 + TypeScript + Zustand 5 + Tailwind CSS 4 | | Backend | Rust (tauri commands) | | DB | SQLite

765mo agoDiscuss

OktoLabsAICLAUDE.md

okto-pulse

OktoLabsAI/okto-pulse/CLAUDE.md

README.md`; this file is for procedures. This repo is the deliverable: CLI, embedded frontend, Dockerfile, and the release pipeline. It depends on `okto-pulse-core` (a sibling repo

765mo agoReads credentialsDiscuss

ryakerCLAUDE.md

zora

ryaker/zora/CLAUDE.md

cron and event-triggered routines, heartbeat dashboard/ # Express server + auth middleware + cost tracker + React frontend/ services/ # NegativeCache (cross-session failure memory) integrations/ # AgentBus client lib/ utils/ # error normalizer; logger

768mo agoDiscuss

sneg55CLAUDE.md

agent-starter / templates

sneg55/agent-starter/templates/CLAUDE.md

first time touching the React side" → save: deep Go expertise, new to React - frame frontend explanations in terms of backend analogues ### feedback **What it stores:** Guidance the user has given

764mo agoDiscuss

deciderCLAUDE.md

claude-hooks

decider/claude-hooks/CLAUDE.md

cascade with local overrides Example: ``` project/ ├── .claude/hooks.json # Default settings ├── backend/ │ └── .claude-hooks.json # Stricter Python rules └── frontend/ └── .claude-hooks.json # Different JS/React rules ``` ### Hook Introspection ```bash # See all hooks in your project python3 hooks/list_hooks.py

7515mo agoDiscuss

kivo360CLAUDE.md

OmoiOS / backend

kivo360/OmoiOS/backend/CLAUDE.md

Claude Code (claude.ai/code) when working with code in this repository. ## Production Domains - **Frontend**: `https://omoios.dev` - **Backend API**: `https://api.omoios.dev` ### Stripe Webhook Configuration The Stripe webhook endpoint is: ``` https://api.omoios.dev

758mo agoReads credentialsDiscuss

kivo360CLAUDE.md

OmoiOS

kivo360/OmoiOS/CLAUDE.md

Requirements → Design → Tasks → Execution) using the Claude Agent SDK and OpenHands SDK. **Production URLs:** - Frontend: `https://omoios.dev` - Backend API: `https://api.omoios.dev` ### Deployment Infrastructure **Vercel Projects** (org: `automation-workz`): | Project

758mo agoReads credentialsDiscuss

kivo360CLAUDE.md

OmoiOS

kivo360/OmoiOS/docs/CLAUDE.md

758mo agoDiscuss

kivo360CLAUDE.md

OmoiOS / frontend

kivo360/OmoiOS/frontend/CLAUDE.md

Time | T | Title | Read | |----|------|---|-------|------| | #6398 | 11:21 PM | 🔵 | Searched for event-related components in frontend directory with no results found

758mo agoDiscuss

sbussoCLAUDE.md

claude-workflow

sbusso/claude-workflow/CLAUDE.md

system automatically detects project type and adapts: #### **Project Type Detection** - **Web Application**: React, Next.js, frontend frameworks → Uses web-app templates - **API Service**: FastAPI, Django, Express, Go APIs → Uses api-service

7516mo agoDiscuss

SebastianElvisCLAUDE.md

octopus

SebastianElvis/octopus/CLAUDE.md

style UI to track session status, integrated terminal/editor, git operations, and GitHub integration. ## Commands ### Frontend (from repo root) ```bash npm run dev # Vite dev server npm run build # tsc --noEmit

756mo agoDiscuss

PersonalJarvisCLAUDE.md

PersonalJarvis

PersonalJarvis/PersonalJarvis/CLAUDE.md

ephemeral-port pool and NOTHING on the machine can connect for two minutes. Frontend goes through `lib/connectBudget.ts`; a poll reuses a client from `jarvis/core/http_pool.py`. (AP-33) - **No Windows Service** — SYSTEM

744d agoReads credentialsDiscuss

timoconnellausCLAUDE.md

claude-code-discord-bot

timoconnellaus/claude-code-discord-bot/CLAUDE.md

WebSocket` (instead of ws library) - `Bun.$`command`` for shell commands (instead of execa) ## Frontend Development If adding frontend features, use HTML imports with `Bun.serve()`: - HTML files can directly import .tsx/.jsx/.js

7416mo agoReads credentialsDiscuss

MicrosoftCLAUDE.md

omnichannel-chat-widget

microsoft/omnichannel-chat-widget/CLAUDE.md

Type | Purpose | Typical Location | |------------|------|---------|------------------| | **CRM.Omnichannel** | Monorepo (Backend) | 20+ microservices for Omnichannel platform | ` /CRM.Omnichannel/` | | **ConversationControl** | Frontend (Agent UI) | Agent experience and conversation management UI | ` /CRM.OmniChannel.ConversationControl/` | | **LiveChatWidget** | Frontend (Customer) | Customer-facing chat

734mo agoDeletes or force-pushesDiscuss

opencoredevCLAUDE.md

openchat

opencoredev/openchat/CLAUDE.md

guidelines for AI agents working on this codebase. ## Project Structure ``` apps/ web/ # TanStack Start frontend (Vite + TanStack Router) server/ # Convex backend ``` ## Routing The app uses **TanStack Router** with file-based

727mo agoReads credentialsDiscuss

hexxt-gitCLAUDE.md

ccpool

hexxt-git/ccpool/CLAUDE.md

neither is wired into the product — don't build features on them. ### Design system (frontend and web) strictly follow `apps/web/DESIGN.md` ### One path to the ledger, one boundary Every machine reaches

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