agentleFS
Sign inSign up

CLAUDE.md examples from real projects

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

Most stars first · from page 3Worked for most · soon
ruvnetCLAUDE.md

ruflo

ruvnet/ruflo/CLAUDE.md

Public release train: @claude-flow/cli, claude-flow, and ruflo. Use package manifests and the registry as version truth; do not copy stale version or capability counts into agent guidance. Ruflo is the coordination ledger and policy decision point. Claude Code executes code, tests, commands, and file changes. A Ruflo coordination call records work; it does not perform the implementation. When registered, call guidance_brain({ mode: "recommend", task: "..." }) before complex Ruflo work. Use its live registry rather than guessing tool names. Treat…

73k21d agoReads credentialsDiscuss
ruvnetCLAUDE.md

ruflo / v3

ruvnet/ruflo/v3/CLAUDE.md

This directory contains the V3 monorepo packages. Root CLAUDE.md rules apply here. Source of truth: docs/reviews/intelligence-system-audit-2026-05-29.md + scripts/benchmark-intelligence.mjs. Numbers below are measured unless marked "target/unverified".

73k21d agoDiscuss
career-ops-hqCLAUDE.md

career-ops

career-ops-hq/career-ops/CLAUDE.md

No summary in the file. Open it to read it.

73k34d agoDiscuss
colbymchenryCLAUDE.md

codegraph

colbymchenry/codegraph/CLAUDE.md

Claude Code project guidance for this repository. Primary instructions live in the canonical agent guide — import it:

72k57d agoDiscuss
diegosouzapwCLAUDE.md

OmniRoute

diegosouzapw/OmniRoute/CLAUDE.md

All project rules live in AGENTS.md — the single source of truth for every AI assistant (architecture, conventions, testing, quality gates, git workflow, the 23 Hard Rules, PII learnings). Read it in full; do not re-add project rules here. Everything below applies ONLY to Claude Code — operational refinements of rules already defined in AGENTS.md. The full mandatory worktree protocol (base-branch confirmation, .claude/worktrees/ canonical path, cp -al node_modules, teardown rules) is in AGENTS.md → Git Workflow → "Worktree isolation". Claude-Code-specific…

71k12d agoDiscuss
shanraisshanCLAUDE.md

claude-code-best-practice

shanraisshan/claude-code-best-practice/CLAUDE.md

This is a best practices repository for Claude Code configuration, demonstrating patterns for skills, subagents, hooks, and commands. It serves as a reference implementation rather than an application codebase. Two skill patterns: agent skills (preloaded via skills: field) vs skills (invoked via Skill tool). See orchestration-workflow/orchestration-workflow.md for the complete flow diagram. Hook events configured in .claude/settings.json: PreToolUse, PostToolUse, UserPromptSubmit, Notification, Stop, SubagentStart, SubagentStop, PreCompact, SessionStart, SessionEnd, Setup, PermissionRequest, TeammateIdle, TaskCompleted, ConfigChange. Special handling: git commits trigger pretooluse-git-committing sound. Be explicit…

66k5mo agoDiscuss
calesthioCLAUDE.md

OpenMontage

calesthio/OpenMontage/CLAUDE.md

**MANDATORY: Read AGENT_GUIDE.md before responding to ANY user message.** Do not act on the user's request until you have read AGENT_GUIDE.md. It contains routing rules that determine your first action…

59k43d agoDiscuss
JetBrainsCLAUDE.md

kotlin

JetBrains/kotlin/CLAUDE.md

CRITICAL: @./.ai/guidelines.md guidelines MUST be followed at all times. Local Preferences: @./.claude/local.md When asked to update memory, you must update ./.claude/CLAUDE.md if it is not specified that another file should…

53k29d agoDiscuss
AnthropicCLAUDE.md

claude-cookbooks / chief_of_staff_agent

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

Output: JSON with monthlyburn, runwaymonths, totalrunwaydollars, quarterlyburn, and burnrate_daily Remember: As Chief of Staff, you have access to financial data in the financial_data/ directory and can delegate specialized analysis to your subagents (financial-analyst and recruiter).

53k8mo agoDiscuss
AnthropicCLAUDE.md

claude-cookbooks

anthropics/claude-cookbooks/CLAUDE.md

A collection of Jupyter notebooks and Python examples for building with the Claude API. Or directly with uv: Notebooks have relaxed rules for mid-file imports (E402), redefinitions (F811), and variable naming (N803, N806). Branch naming: <username>/<feature-description> Commit format (conventional commits): These commands are available in Claude Code and CI:

53k8mo agoReads credentialsDiscuss
AnthropicCLAUDE.md

claude-cookbooks / skills

anthropics/claude-cookbooks/skills/CLAUDE.md

This is a comprehensive Jupyter notebook cookbook demonstrating Claude's Skills feature for document generation (Excel, PowerPoint, PDF). It's designed for developers learning to integrate Skills into their applications. Beta API Requirements: - All Skills functionality uses client.beta.* namespace - Required beta headers: code-execution-2025-08-25, files-api-2025-04-14, skills-2025-10-02 - Must use client.beta.messages.create() with container parameter - Code execution tool (codeexecution20250825) is REQUIRED - Use pre-built Agent skills by referencing their skill_id or create and upload your own via the Skills API Files API…

53k8mo agoReads credentialsDiscuss
CherryHQCLAUDE.md

cherry-studio

CherryHQ/cherry-studio/CLAUDE.md

How to approach any coding task in this repo. Project-specific tools, paths, and conventions.

52k43d agoDiscuss
Imbad0202CLAUDE.md

academic-research-skills

Imbad0202/academic-research-skills/.claude/CLAUDE.md

A suite of Claude Code skills for rigorous academic research, paper writing, peer review, and pipeline orchestration.

50k7d agoDiscuss
QuantumNousCLAUDE.md

new-api

QuantumNous/new-api/CLAUDE.md

Do not treat @AGENTS.md as loaded. Claude Code does not reliably inline that import. Before any planning, coding, reviewing, or answering a project question, you MUST call the Read tool…

49k13d agoDiscuss
jeecgbootCLAUDE.md

JeecgBoot / jeecg-boot

jeecgboot/JeecgBoot/jeecg-boot/CLAUDE.md

You should always answer questions in Simplified Chinese first, unless the user explicitly requests another language. JeecgBoot 3.9.5 — a Java low-code development platform built on Spring Boot 4.1.0, Java 17 (also supports 21, 24). It runs as a monolithic app by default, with an optional Spring Cloud microservices mode. Uses jakarta namespace (not javax) throughout. Optional microservices modules (activated via -P SpringCloud): - jeecg-server-cloud/ — Gateway (port 9999), Nacos (8848/18080), cloud service starters, monitoring (9111), XXL-Job (9080), Sentinel (9000)

48k12mo agoDiscuss
jeecgbootCLAUDE.md

JeecgBoot / jeecgboot-vue3

jeecgboot/JeecgBoot/jeecgboot-vue3/CLAUDE.md

JeecgBoot Vue3 frontend — an enterprise low-code platform built with Vue 3 + Vite 6 + Ant Design Vue 4 + TypeScript. Uses pnpm as package manager. Node 18 or 20+ required (engines: "^18 || >=20"). The /@/ prefix (with leading slash) is the project's conventional alias — prefer it for consistency. createApp → createRouter → setupStore (pinia) → setupProps → i18n → initAppConfigStore → registerPackages (@jeecg/online) → registerGlobComp (core Ant Design components) → SSO login → registerSuper (dynamic module…

48k12mo agoReads credentialsDiscuss
danny-avilaCLAUDE.md

LibreChat

danny-avila/LibreChat/CLAUDE.md

LibreChat is a monorepo with the following key workspaces: The source code for @librechat/agents (major backend dependency, same team) lives at <https://github.com/LibreChat-AI/agents>. - All new backend code must be TypeScript in /packages/api. - /api holds wiring, not behavior. When a change would add logic to a CJS file under /api — a branch, a helper, a validation step, a new service call — that logic goes in /packages/api, and the JS file keeps only what wires it up: requires, route…

45k49d agoDiscuss
K-Dense-AICLAUDE.md

scientific-agent-skills

K-Dense-AI/scientific-agent-skills/CLAUDE.md

Repository guidance for this project lives in AGENTS.md. Read it and follow it.

45k2mo agoDiscuss
MadsLorentzenCLAUDE.md

ai-job-search

MadsLorentzen/ai-job-search/CLAUDE.md

No summary in the file. Open it to read it.

44k3d agoDiscuss
agno-agiCLAUDE.md

agno

agno-agi/agno/CLAUDE.md

Instructions for AI coding agents (Claude Code, Codex, Cursor, etc.) working on this codebase. When working in Conductor, you can use the .context/ directory for scratch notes or agent-to-agent handoff artifacts. This directory is gitignored. The specs/ and docs/ directories are symlinked from external locations. For a fresh clone or new workspace, create these symlinks: These contain private design documents and documentation that are not checked into the repository. This project uses two virtual environments: Use .venv for development tasks…

42k16mo 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.