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 26Worked for most · soon
RchGravCLAUDE.md

claudebox / claude

RchGrav/claudebox/claude/CLAUDE.md

CRITICAL: Always consider TDD discipline before starting any coding task Key behavioral change: Make TDD consideration automatic, not optional. CRITICAL: Always run these checks before any commit: All tests must pass before any commit or push: When tests fail: - Investigate the root cause - Don't just change the test, understand why it's failing - Fix the implementation or test - Address the actual issue, whether in code or test logic - Verify the fix - Run the full test…

1.2k16d agoDiscuss
RchGravCLAUDE.md

claudebox

RchGrav/claudebox/CLAUDE.md

You are a Senior Bash/Docker Engineer with deep expertise in shell scripting and containerization. You're working on ClaudeBox, a Docker-based development environment for Claude CLI that you co-created with the user. This tool has 1000+ users and enables multiple Claude instances to communicate via tmux, provides dynamic containerization, and includes various development profiles. THIS SCRIPT USES set -euo pipefail EXTENSIVELY - This means ANY command that returns non-zero will cause the entire script to exit immediately.

1.2k16d agoDiscuss
cookjohnCLAUDE.md

zotero-mcp / zotero-mcp-plugin

cookjohn/zotero-mcp/zotero-mcp-plugin/CLAUDE.md

Key points: - Version in: package.json, README.md, README-zh.md (badge), update.json - Build: npm run build → .scaffold/build/zotero-mcp-plugin.xpi - addon/ is gitignored — use git add -f for files under it - Release assets: XPI (renamed to zotero-mcp-plugin-X.Y.Z.xpi) + update.json

1.2k7mo agoDiscuss
NVIDIACLAUDE.md

earth2studio

NVIDIA/earth2studio/CLAUDE.md

See AGENTS.md for project rules, skills, conventions, and environment setup.

1.1k2mo agoDiscuss
DeepMystCLAUDE.md

Mysti

DeepMyst/Mysti/CLAUDE.md

Mysti is a VSCode extension providing a unified AI coding assistant interface supporting 12 AI backends (Claude Code, OpenAI Codex, Google Gemini, Cline, GitHub Copilot, Cursor, OpenClaw, OpenCode, Qwen Code, Ollama, LocalAI, and Manus). It features sidebar/tab chat panels, conversation persistence, multi-agent brainstorm mode (any 2 of 11 agents with 5 collaboration strategies), autonomous mode with safety classification, @-mention agent routing, permission controls, plan selection, context compaction, and a three-tier agent loading system for personas and skills. Output: dist/extension.js from…

1.1k7mo agoPipes a download into a shellDiscuss
ClawBioCLAUDE.md

ClawBio

ClawBio/ClawBio/CLAUDE.md

You are ClawBio, a bioinformatics AI agent. You answer biological and genomic questions by routing to specialised skills — never by guessing. Every answer must trace back to a SKILL.md…

1.1k7mo agoDiscuss
KroMioseCLAUDE.md

nekro-agent

KroMiose/nekro-agent/CLAUDE.md

请先阅读并遵循以下规则文档,再开始修改代码: 如涉及插件或前端视觉规范,请额外阅读: 所有命令在项目根目录 /home/miose/Projects/nekro-agent 下执行。 注意: 如果遇到权限问题,请使用 sudo 命令。

1.1k6mo agoDiscuss
917DhjCLAUDE.md

DeepPaperNote

917Dhj/DeepPaperNote/CLAUDE.md

skills/deeppapernote/SKILL.md is both the canonical workflow definition and the Claude Code skill entrypoint. .claude-plugin/plugin.json identifies the plugin, but it must not restate the workflow. End users running Claude Code invoke the skill with natural language or the /deeppapernote slash command. Recognized trigger examples: - 给这篇论文生成深度笔记 - 写一篇高质量论文精读笔记 - 把这篇文章整理成 obsidian 笔记 - /deeppapernote <paper title, DOI, arXiv ID, or local PDF path>

1.1k4d agoDiscuss
AltanSCLAUDE.md

collie

AltanS/collie/CLAUDE.md

Collie (repo AltanS/collie) — a phone web UI for the AI agents running in your terminal, served over Tailscale. A mobile-first PWA (Vite + React + TS + Tailwind v4 + shadcn) plus a Bun/TS bridge that mirrors ONE multiplexer per install — Herdr, tmux or zellij — letting you monitor and reply to agents from a phone. Herdr is one adapter among the three, not the product: it is the default, it is the only one that talks over…

1.1k44d agoDiscuss
AlexSergeyCLAUDE.md

rockpack

AlexSergey/rockpack/CLAUDE.md

Do not analyze or modify generated/dependency files. Never edit generated code manually.

1.1k5d agoDiscuss
withkynamCLAUDE.md

vibecode-pro-max-kit

withkynam/vibecode-pro-max-kit/CLAUDE.md

If process/context/all-context.md does not exist, the harness has not been set up yet. (Note: process/context/ itself may already hold only generated-skills-catalog.json from install — that alone does NOT count as set up.) Run vc-setup before any task — the context router, protocol docs, and the validator suite are absent and agents will not route correctly. Mandatory gate: Do not proceed to load any context file until both find commands have run and their full output has been read. Substituting ls…

1.1k3mo agoDiscuss
bubblelabaiCLAUDE.md

BubbleLab

bubblelabai/BubbleLab/CLAUDE.md

Read .cursor/rules/bubblelab.mdc to understand bubble lab, ALWAYS Read this before every conversation.

1.1k8mo agoDiscuss
K9i-0CLAUDE.md

ccpocket

K9i-0/ccpocket/CLAUDE.md

Claude Code / Codex 対応モバイルクライアント。Bridge は packages/bridge/(TypeScript / WebSocket)、アプリは apps/mobile/(Flutter / Dart)。npm workspaces を使う。 Bridge と Flutter の両方を変更する場合は両方の検証を選ぶ。文書のみの変更は参照・形式・内容を検証する。 依頼された操作に対応するスキルを読む。リリース作成と既存ビルドの審査提出は別の操作。 .claude/agents/ に code-reviewer と e2e-verifier がある。利用できる環境で、独立したレビュー・検証が有効な場合に使う。 Claude用のhookは .claude/settings.json と .claude/hooks/ を参照する。post-edit-analyze は対象Dartファイルを解析し、pre-stop-check は lib/ の解析と条件付きテストを行う。実際に実行された検証結果を確認し、重複実行を避ける。

1.1k8mo agoDiscuss
weieskyCLAUDE.md

cc-viewer

weiesky/cc-viewer/CLAUDE.md

Using !important in CSS is 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 run build must be run. Never commit package-lock.json. Any new dependency that ships an install/postinstall script must first be added to allowBuilds in pnpm-workspace.yaml. Before committing to GitHub, pnpm run test:cli must pass. New scripts under packages/app/server/* must come with unit tests in packages/app/test/. Update…

1.1k13d agoDiscuss
openops-cloudCLAUDE.md

openops

openops-cloud/openops/CLAUDE.md

Always invoke the relevant skill before starting these tasks — they carry additional patterns, anti-patterns, and context that are not in AGENTS.md:

1.1k3mo agoDiscuss
jarrodwattsCLAUDE.md

claude-code-config

jarrodwatts/claude-code-config/CLAUDE.md

Identity: SF Bay Area engineer. Work, delegate, verify, ship. No AI slop. Core Competencies: - Parsing implicit requirements from explicit requests - Adapting to codebase maturity (disciplined vs chaotic) -…

1.1k8mo agoDiscuss
vstorm-coCLAUDE.md

pydantic-deepagents

vstorm-co/pydantic-deepagents/CLAUDE.md

- pydanticdeep/ — Core library (agent, deps, models, instructions, types) - pydanticdeep/features/<name>/ — One vertical-slice package per feature (capability.py + toolset.py + service.py/types.py). Organize by feature, not by kind — features/ is the only import location; the old toolsets/, capabilities/, processors/ and improve/ shims were removed in 0.3.39. - apps/cli/ — CLI + TUI application (Textual-based terminal AI assistant) - apps/deepresearch/ — Full-featured research reference app - tests/ — Unit tests - docs/ — Documentation source (MkDocs) **Agent Factory (pydantic_deep/agent.py)**…

1.1k5mo agoDiscuss
Mininglamp-OSSCLAUDE.md

octo-server

Mininglamp-OSS/octo-server/CLAUDE.md

Octo-server is the Go backend for DMWork (enterprise IM platform). It handles business logic on top of WuKongIM for messaging transport. 27 modules in modules/, each auto-registered via init() + register.AddModule(). Standard module structure: - 1module.go — registration entry (init() + register.AddModule()) - api*.go — HTTP handlers implementing register.APIRouter.Route(r wkhttp.WKHttp) - service.go — business logic, typically defines IService interface - db.go — database operations using gocraft/dbr - model.go — data models and response structs - sql/ — SQL migrations embedded…

1.1k3mo agoDiscuss
nateherkaiCLAUDE.md

hyperframes-student-kit

nateherkai/hyperframes-student-kit/CLAUDE.md

Turn a talking-head recording into an intentional edit using local HyperFrames rendering, transcript-driven cuts, and reusable motion graphics. AGENTS.md and CLAUDE.md contain the same standing guide. Keep them synchronized. Claude…

1.1k6d agoDiscuss
zhnnky329CLAUDE.md

MathModeling-skills

zhnnky329/MathModeling-skills/CLAUDE.md

AGENTS.md is the single source of truth for workflow policy, gates, artifacts, human decisions, risk probes, freezing, and audits. Read and follow it before invoking a modeling skill. .claude/skills/ is a complete standalone skill tree, not an adapter to .codex/skills/. When maintaining a shared skill, keep the full counterpart in both trees and validate both; do not replace either copy with wrappers or symlinks. The native distribution package lives under plugins/mathmodeling-skills/. After updating both standalone trees, run scripts/sync-plugin.sh and validate…

1.1k38d 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.