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

Maneek21CLAUDE.md

Deft

Maneek21/Deft/CLAUDE.md

constants ├── docker-compose.yml # Self-host: postgres + app ├── .env.example ├── LICENSE # GNU AGPL v3.0 only └── pnpm-workspace.yaml ``` **Stack:** - Frontend: Next.js 14, App Router, TypeScript, Tailwind CSS, TipTap (editor) - API: Hono on Node.js, TypeScript - Database

2214mo agoReads credentialsDiscuss

nirholasCLAUDE.md

three.ws

nirholas/three.ws/CLAUDE.md

# three.ws: Operating Rules for Claude Agents These rules OVERRIDE defaults. Every agent in this

21711d agoReads credentialsDiscuss

LerianStudioCLAUDE.md

ring

LerianStudio/ring/CLAUDE.md

Gate 0 per task, Gate 8/9 per epic, Step 11.5 phase boundary) | | Dev cycle frontend | `ring:running-dev-cycle-frontend` → rolling-wave phased cycle (Gate 0 per task, Gate

2152mo agoDiscuss

FerroxLabsCLAUDE.md

ijfw

FerroxLabs/ijfw/CLAUDE.md

point. IJFW orchestrates think-build-ship end to end and dispatches peer specialist skills (frontend-design, TDD, code-review) as subagent tools when the workflow needs them

2105mo agoDiscuss

NicholasSpisakCLAUDE.md

claude-code-subagents

NicholasSpisak/claude-code-subagents/CLAUDE.md

specifications ### Agent Categories **Technical Specialists:** - `backend-reliability-engineer`: Server-side systems, APIs, databases, microservices - `frontend-ux-specialist`: UI/UX components, accessibility, performance, mobile-first development - `systems-architect`: System design, scalability, architectural

21014mo agoDiscuss

lidge-aiCLAUDE.md

cli-jaw

lidge-ai/cli-jaw/CLAUDE.md

After changing `server.ts`/`src/**`/`bin/**`, run `npm run build` before telling anyone to restart; frontend changes additionally need `npm run build:frontend`. Full rules: `AGENTS.md` § Build & Deploy Contract. ## Current Runtime

2086d agoDiscuss

dmarcguardhqCLAUDE.md

parse-dmarc

dmarcguardhq/parse-dmarc/CLAUDE.md

assistant integration. ## Tech Stack - **Backend**: Go 1.25.4 (see go.mod for exact version) - **Frontend**: Vue.js 3 with Vite - **Database**: SQLite (supports both CGO and pure-Go variants) - **Package Manager

20710d agoDiscuss

xiaojiou176-openCLAUDE.md

codeflow

xiaojiou176-open/codeflow/CLAUDE.md

fallbacks disabled on mainline; staged dashboard UI-audit workspaces must also keep package-local frontend sources inside the temporary workspace root instead of relying on out-of-root symlinks that

2074mo agoReads credentialsDiscuss

DatabricksCLAUDE.md

app-templates / e2e-chatbot-app-next

databricks/app-templates/e2e-chatbot-app-next/CLAUDE.md

Foundation Model endpoints. **Key characteristics:** - Monorepo architecture with npm workspaces - Express.js backend + React frontend (Vite) - PostgreSQL database with Drizzle ORM - Vercel AI SDK for streaming responses - Databricks-native authentication

2025mo agoReads credentialsDiscuss

Idun-GroupCLAUDE.md

idun-agent-platform

Idun-Group/idun-agent-platform/CLAUDE.md

Mypy. - Schema changes land in `idun_agent_schema` first, then engine and standalone consumers. Frontend types regenerate from the standalone OpenAPI spec. ## Coding Guidelines — Severity Matrix (auto-generated) | ID | Title

2025mo agoDiscuss

webdevtodayjasonCLAUDE.md

sub-agents

webdevtodayjason/sub-agents/CLAUDE.md

Task("project-planner: Design user authentication system") Task("api-developer: Implement auth endpoints") Task("frontend-developer: Create login/register UI") Task("tdd-specialist: Write comprehensive tests") Task("security-scanner: Verify auth

2014mo agoDiscuss

TheBushidoCollectiveCLAUDE.md

han

TheBushidoCollective/han/CLAUDE.md

formatting - Plugin names use short identifiers matching their directory name (e.g., `typescript`, `github`, `frontend-development`) - Always include `bushido` as a dependency in recommendations - MCP servers in bridge/service plugins should

1956mo agoPipes a download into a shellDiscuss

AWSCLAUDE.md

loom

awslabs/loom/CLAUDE.md

exposed via API. - `etc/`: Configuration management. - `environment.sh`: Source of truth for all injectable parameters. - `frontend/`: Frontend used for interacting with the backend. - `iac/`: Infrastructure as Code (AWS CloudFormation

1873mo agoReads credentialsDiscuss

theaiautomatorsCLAUDE.md

claude-code-agentic-rag-masterclass

theaiautomators/claude-code-agentic-rag-masterclass/CLAUDE.md

chat (default) and document ingestion interfaces. Config via env vars, no admin UI. ## Stack - Frontend: React + Vite + Tailwind + shadcn/ui - Backend: Python + FastAPI - Database: Supabase (Postgres, pgvector, Auth, Storage, Realtime

1858mo agoDiscuss

jenticCLAUDE.md

jentic-one

jentic/jentic-one/CLAUDE.md

collector) │ └── values/ # Per-mode + per-overlay value files └── terraform/ # Terraform modules and environment compositions ``` ## Frontend (`ui/`) The single-page app lives in [`ui/`](ui/) (React + Vite + Tailwind, TanStack Query

1833mo agoDiscuss

jtgsystemsCLAUDE.md

Custom-Modes-Roo-Code

jtgsystems/Custom-Modes-Roo-Code/CLAUDE.md

agents) **Location**: `agents/core-development/` **Focus**: Foundation development roles and architectures - Full-Stack Developers - Backend Specialists - Frontend Experts - System Architects - API Designers - Integration Specialists ### 4. Infrastructure & DevOps (14 agents) **Location**: `agents/infrastructure-devops/` **Focus

1839mo agoDiscuss

PerpetualSoftwareCLAUDE.md

pad

PerpetualSoftware/pad/CLAUDE.md

SvelteKit site deployed to Vercel. ## Architecture - **Backend:** Go (cmd/pad/main.go) → REST API (internal/server/) → SQLite (internal/store/) - **Frontend:** SvelteKit 2 + Svelte 5 (web/src/) → static build embedded in Go binary - **Data model:** Workspaces → Collections

1826mo agoReads credentialsDiscuss

PostHogCLAUDE.md

duckgres

PostHog/duckgres/CLAUDE.md

# Claude Code Context for Duckgres This file provides context for Claude Code sessions working

1828mo agoReads credentialsDiscuss

Hugging FaceCLAUDE.md

leLab

huggingface/leLab/CLAUDE.md

replay, and training as HTTP/WebSocket endpoints, replacing LeRobot's CLI + keyboard-driven flows. The frontend (React + Vite) lives in [`frontend/`](frontend/). The built bundle in [`frontend/dist/`](frontend/dist/) is committed

18117d agoDiscuss

zerowand01CLAUDE.md

markplane

zerowand01/markplane/CLAUDE.md

warning-free) ``` Web UI (optional): ```bash cd crates/markplane-web/ui && npm install && npm run build # Build frontend cargo install --path crates/markplane-cli --features embed-ui # Single binary with embedded UI ``` After code changes

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