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 27Worked for most · soon
MongoDBCLAUDE.md

mongo-tools

mongodb/mongo-tools/CLAUDE.md

Claude Code reads CLAUDE.md, not AGENTS.md. This repo keeps its agent instructions in AGENTS.md so that every coding agent reads the same file; the import below pulls them in. Add…

1.1k30d agoDiscuss
AgriciDanielCLAUDE.md

banana-claude

AgriciDaniel/banana-claude/CLAUDE.md

This repository is a Claude Code plugin for brief-led Gemini image generation, editing, visual review, and bounded multi-model comparison. - .claude-plugin/plugin.json declares metadata and the sensitive Gemini key user configuration. - .mcp.json starts the bundled zero-dependency Python stdio server. - skills/banana/SKILL.md owns routing, creative brief, approval, execution, and review behavior. - skills/banana/references/models.json is the executable model, capability, deprecation, and image-output pricing registry. - skills/banana/scripts/bananacore.py routes Interactions and generateContent requests, validates capabilities, parses responses, and writes artifacts. - skills/banana/scripts/approvalstore.py owns the…

1k33d agoDiscuss
docckerCLAUDE.md

cc-use-exp

doccker/cc-use-exp/.claude/CLAUDE.md

LANGUAGE: Simplified Chinese (简体中文) — 详见 rules/chinese-language.md CRITICAL: You MUST respond in Simplified Chinese at ALL times unless explicitly requested otherwise. 默认回复、注释、commit message 使用简体中文。技术术语保持英文原文。 版本:v1.0 作者:wwj 更新:2026-03-10 全栈开发者,主要技术栈:Go、Java、Vue + TypeScript、SQLite/MySQL/PostgreSQL

1k4mo agoDiscuss
beizhu-1209CLAUDE.md

AIHelms / apps

beizhu-1209/AIHelms/apps/CLAUDE.md

Layered architecture: Router(api/) → Service(services/) → Repository(repositories/) → Database No cross-layer calls: Router must not operate database directly. Service must not import FastAPI Request/Response. Repository must not contain business logic.

1k5mo agoDiscuss
beizhu-1209CLAUDE.md

AIHelms / ui

beizhu-1209/AIHelms/ui/CLAUDE.md

npm workspace monorepo with three packages: Rule: admin and web must not import from each other. Shared code goes through @aihelms/shared.

1k5mo agoDiscuss
jezwebCLAUDE.md

claude-skills

jezweb/claude-skills/CLAUDE.md

Repository: https://github.com/jezweb/claude-skills Owner: Jeremy Dawes (Jez) | Jezweb Production workflow skills for Claude Code CLI. Each skill guides Claude through a recipe to produce tangible output — not knowledge dumps, but working deliverables.

1k7mo agoDiscuss
stackqlCLAUDE.md

stackql

stackql/stackql/CLAUDE.md

Project memory for Claude Code working on stackql. The canonical contributor guide is imported below. Do not duplicate its content here - edit AGENTS.md instead. Add entries here only when they are Claude Code-specific and not appropriate for AGENTS.md (e.g. tool allowlists, hook notes, harness quirks). Everything else belongs in AGENTS.md or the docs it links to.

1k58d agoDiscuss
CloudflareCLAUDE.md

nimbus

cloudflare/nimbus/CLAUDE.md

Read this first if you're an AI agent picking up work on the Nimbus codebase. Sister file CLAUDE.md mirrors this content — keep them in sync. Nimbus builds documentation sites on Astro. The architecture splits into three tiers: Cloudflare is a first-class deploy target (the scaffolder defaults to it and ships wrangler.jsonc), but the framework is deploy-target agnostic — static output runs anywhere. Root build runs at default concurrency; pnpm -r topo order builds nimbus-docs first. apps/www's build no longer…

1k17d agoDiscuss
CloudflareCLAUDE.md

nimbus / nimbus-starter-source

cloudflare/nimbus/packages/nimbus-starter-source/CLAUDE.md

Read and follow AGENT.md. It is the canonical project guidance for editing, auditing, upgrading, and validating this Nimbus site.

1k17d agoDiscuss
NVIDIACLAUDE.md

cudf-spark

NVIDIA/cudf-spark/.claude/CLAUDE.md

@../AGENTS.md Follow the imported agent-specific repository policy for all code, review, commit, and pull request work. Consult the linked human process documents on demand only when the task needs more…

1k35d agoDiscuss
StripeCLAUDE.md

stripe-java

stripe/stripe-java/.claude/CLAUDE.md

It's ok not to put comments on/in a function if their addition wouldn't meaningfully clarify anything.

1k7mo agoDiscuss
bytechefhqCLAUDE.md

bytechef

bytechefhq/bytechef/CLAUDE.md

ByteChef is an open-source, low-code API integration and workflow automation platform built on Spring Boot. It serves as both an automation solution and an embedded iPaaS (Integration Platform as a…

1k11mo agoDiscuss
ix-infrastructureCLAUDE.md

Ix

ix-infrastructure/Ix/CLAUDE.md

This checkout is Ix itself plus the ix agent skill that wraps it. The backend is NOT in this repo — it is the released Docker image running at http://localhost:8090; the Compass visualizer serves the SPA + API proxy on http://localhost:8080. Requires Node ≥ 22, git, Docker, ripgrep. - ix reset is GLOBAL. ix reset / ix reset --code take no workspace_id and wipe every workspace's graph in the shared backend (Ix + packwise + any other). The only scoped…

1k7mo agoDiscuss
jarrodwattsCLAUDE.md

claude-delegator

jarrodwatts/claude-delegator/CLAUDE.md

A Claude Code plugin that provides GPT (via Codex CLI) and Gemini (via Gemini CLI) as specialized expert subagents. Five domain experts that can advise OR implement: Architect, Plan Reviewer, Scope Analyst, Code Reviewer, and Security Analyst. No build step, no dependencies. Uses native MCP servers from Codex and Gemini CLIs. Claude acts as orchestrator—delegates to specialized experts based on task type. Supports both single-shot (independent calls) and multi-turn (context preserved via threadId). Every delegation prompt must include: TASK, EXPECTED…

9957mo agoDiscuss
AlmanacCodeCLAUDE.md

codealmanac

AlmanacCode/codealmanac/CLAUDE.md

COMPULSORY — read MANUAL.md before implementing any feature. It defines how we build: living architecture (the unit of work is "reshape the codebase so the feature fits, then build it"), the seam-vs-machinery rule, the duty to stop and flag when the current shape won't hold a feature cleanly, and the wireframe-in-chat habit. Reason from it; don't bolt features onto a misshapen base. codealmanac is a living wiki for codebases, maintained by AI coding agents. It documents what the code can't…

9934mo agoDiscuss
RyanAlbertsCLAUDE.md

best-of-Agent-Harnesses

RyanAlberts/best-of-Agent-Harnesses/CLAUDE.md

All commits in this repo must be authored as: so they count toward @RyanAlberts's GitHub contribution graph. Set both author and committer — GitHub matches on author email, but matching…

9904mo agoDiscuss
xviroboticsCLAUDE.md

metabot

xvirobotics/metabot/CLAUDE.md

The canonical project instructions are in AGENTS.md. Follow that file for this repository. This compatibility file exists for Claude Code; MetaBot install/update does not deploy or replace workspace instruction files.

9886mo agoDiscuss
ericbuessCLAUDE.md

claude-code-docs

ericbuess/claude-code-docs/CLAUDE.md

This repository contains local copies of Claude Code documentation from https://docs.anthropic.com/en/docs/claude-code/ The docs are periodically updated via GitHub Actions. When responding to /docs commands: 1. Follow the instructions in the…

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