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 4Worked for most · soon
nanocoaiCLAUDE.md

nanoclaw / container

nanocoai/nanoclaw/container/CLAUDE.md

You are a NanoClaw agent. Your name, destinations, and message-sending rules are provided in the runtime system prompt at the top of each turn. Be concise — every message costs the reader's attention. Lead with the result, skip preamble and narration, and keep only what the user needs. Prefer outcomes over play-by-play; when the work is done, the final message should be about the result, not a transcript of what you did. Files you create are saved in /workspace/agent/. Use…

31k3d agoDiscuss
googleworkspaceCLAUDE.md

cli

googleworkspace/cli/CLAUDE.md

When contributing to this repository, you must strictly follow all guidelines outlined in the AGENTS.md file.

31k6mo agoDiscuss
ComposioHQCLAUDE.md

composio

ComposioHQ/composio/CLAUDE.md

Claude Code compatibility shim. Use AGENTS.md for repository guidance. Local skills are canonical under .agents/skills; .claude/skills points there for Claude-compatible clients.

30k9d agoDiscuss
ComposioHQCLAUDE.md

composio

ComposioHQ/composio/docs/CLAUDE.md

Claude Code compatibility shim. Use docs/AGENTS.md for documentation-site guidance. Docs-agent context lives in docs/agent-guidance/, and neutral decisions live in docs/decisions/.

30k9d agoDiscuss
chroma-coreCLAUDE.md

chroma

chroma-core/chroma/CLAUDE.md

Use the TYPE: Description format: Common types: ENH (feature/enhancement), BUG (fix), TST (test), DOC (docs), CHORE (maintenance/refactor), BLD (build system changes). Scope is optional but encouraged — use the component name (e.g. rust-client, gc, dashboard-api). - Subject line: ≤ 50 characters. Keeps it readable in git log --oneline, GitHub PR lists, and rebase tooling. - Blank line between subject and body (required — many tools use this to split them). - Body lines: wrap at 72 characters. Leaves room for…

29k3y agoDiscuss
yamadashyCLAUDE.md

repomix / browser

yamadashy/repomix/browser/CLAUDE.md

This file provides guidance for working with the Repomix browser extension. Cross-browser extension (Chrome/Firefox/Edge) that adds Repomix integration to GitHub repository pages. Uses Manifest V3 with content scripts to inject a "Repomix" button directly into GitHub's UI.

29k44d agoDiscuss
yamadashyCLAUDE.md

repomix

yamadashy/repomix/CLAUDE.md

.agents/rules/base.md

29k44d agoDiscuss
jarrodwattsCLAUDE.md

claude-hud

jarrodwatts/claude-hud/CLAUDE.md

This file provides guidance to Claude Code when working with this repository. Claude HUD is a Claude Code plugin that displays a real-time multi-line statusline. It shows context health, tool activity, agent status, and todo progress. Key insight: The statusline is invoked by Claude Code after each interaction (new assistant message, /compact finishing, permission-mode changes, vim-mode toggles), debounced at 300ms — not on a fixed polling loop. Each invocation: 1. Receives JSON via stdin (model, context, tokens - native accurate…

28k9mo agoDiscuss
gastownhallCLAUDE.md

beads

gastownhall/beads/CLAUDE.md

This file is intentionally short. Do not copy workflow, build, storage, or UI rules here; those details drift quickly when repeated across agent entrypoints. - Run bd prime before doing tracked work. - Follow go.mod and AGENTINSTRUCTIONS.md for build and test commands; do not hard-code toolchain versions here. - Beads uses Dolt as the issue database. Use bd dolt push / bd dolt pull for issue data sync; do not use export/import as a routine git workflow. - The CLI…

27k6mo agoDiscuss
gastownhallCLAUDE.md

beads / engdocs

gastownhall/beads/engdocs/CLAUDE.md

beads (command: bd) is a Dolt-powered issue tracker for AI-supervised coding workflows. Git integration is optional — see BEADS_DIR + --stealth for git-free operation. We dogfood our own tool. IMPORTANT: See AGENTS.md for complete workflow instructions, bd commands, and development guidelines. Beads uses Dolt as its storage backend — a version-controlled SQL database: Core implementation: - Dolt storage: internal/storage/dolt/ - Embedded runtime: internal/storage/embeddeddolt/ - Server runtime: internal/doltserver/, internal/storage/db/, and internal/storage/doltserver/ - Sync commands: cmd/bd/dolt*.go, cmd/bd/sync*.go See internal/types/types.go: - Issue: Core…

27k6mo agoDiscuss
manaflow-aiCLAUDE.md

cmux

manaflow-ai/cmux/CLAUDE.md

Keep repo-wide decisions here; procedures belong in CONTRIBUTING.md, area instructions and task skills. Read the matching skill before changing an area, then only the references needed. - Before committing, setup…

27k3d agoDiscuss
manaflow-aiCLAUDE.md

cmux / cmux-tui

manaflow-ai/cmux/cmux-tui/CLAUDE.md

Read and follow AGENTS.md in this directory before you change or verify cmux-tui.

27k3d agoDiscuss
manaflow-aiCLAUDE.md

cmux / ios

manaflow-ai/cmux/ios/CLAUDE.md

Read and follow AGENTS.md in this directory before you change iOS code.

27k3d agoDiscuss
phurynCLAUDE.md

pm-skills

phuryn/pm-skills/CLAUDE.md

Guidance for AI agents (Claude Code, Cowork, and others) working in this repository. This file is the single source of truth for how the project is structured and maintained. PM Skills (phuryn/pm-skills) — a marketplace of 9 independent plugins (68 skills, 42 commands) that bring structured product-management workflows to AI coding assistants. Built for Claude Code and Claude Cowork; the skills are also compatible with other agents (Gemini CLI, Cursor, Codex CLI). Owner: Paweł Huryn — pawel@productcompass.pm — https://www.productcompass.pm

26k3mo agoDiscuss
AnthropicCLAUDE.md

knowledge-work-plugins / slack

anthropics/knowledge-work-plugins/partner-built/slack/CLAUDE.md

This plugin integrates Slack with Claude Code, providing tools to search, read, and send messages in Slack.

26k8mo agoDiscuss
DonchitosCLAUDE.md

Claude-Code-Game-Studios / CCGS Skill Testing Framework

Donchitos/Claude-Code-Game-Studios/CCGS Skill Testing Framework/CLAUDE.md

This folder is the quality assurance layer for the Claude Code Game Studios skill/agent framework. It is self-contained and separate from any game project. The spec: field in catalog.yaml is the authoritative path for each skill/agent spec. Always read it rather than guessing the path.

25k8d agoDiscuss
DonchitosCLAUDE.md

Claude-Code-Game-Studios

Donchitos/Claude-Code-Game-Studios/CLAUDE.md

Indie game development managed through 49 coordinated Claude Code subagents. Each agent owns a specific domain, enforcing separation of concerns and quality. Note: Engine-specialist agents exist for Godot, Unity, and Unreal with dedicated sub-specialists. Use the set matching your engine. @.claude/docs/directory-structure.md project.yaml at the repo root is the primary config store — engine, specialists, naming, platform, performance, modes. Skills resolve it via resolve_config (see .claude/docs/config-resolution.md). .claude/docs/technical-preferences.md is the legacy fallback, read on demand when a key is absent from project.yaml.…

25k8d agoDiscuss
DonchitosCLAUDE.md

Claude-Code-Game-Studios / design

Donchitos/Claude-Code-Game-Studios/design/CLAUDE.md

When authoring or editing files in this directory, follow these standards. The 8 GDD sections, in order: 1. Overview — one-paragraph summary 2. Player Fantasy — intended feeling and experience 3. Detailed Rules — unambiguous mechanics 4. Formulas — all math defined with variables 5. Edge Cases — unusual situations handled 6. Dependencies — other systems listed 7. Tuning Knobs — configurable values identified 8. Acceptance Criteria — testable success conditions How many are REQUIRED depends on modes.workflow — all…

25k8d agoDiscuss
DonchitosCLAUDE.md

Claude-Code-Game-Studios

Donchitos/Claude-Code-Game-Studios/docs/CLAUDE.md

When authoring or editing files in this directory, follow these standards. Use the ADR template: .claude/docs/templates/architecture-decision-record.md Required sections: Title, Status, Context, Decision, Consequences, ADR Dependencies, Engine Compatibility, GDD Requirements Addressed Status lifecycle: Proposed → Accepted → Superseded - Never skip Accepted — stories referencing a Proposed ADR are auto-blocked - Use /architecture-decision to create ADRs through the guided flow TR Registry: docs/architecture/tr-registry.yaml - Stable requirement IDs (e.g. TR-MOV-001) that link GDD requirements to stories - Never renumber existing IDs —…

25k8d agoDiscuss
DonchitosCLAUDE.md

Claude-Code-Game-Studios / src

Donchitos/Claude-Code-Game-Studios/src/CLAUDE.md

When writing or editing game code in this directory, follow these standards. The LLM's training data predates the pinned engine version. Always check docs/engine-reference/ before using any engine API. Do not guess at post-cutoff API signatures — look them up first. - All public APIs require doc comments - Gameplay values must be data-driven (external config files), never hardcoded - Prefer dependency injection over singletons for testability - Architecture decisions go in docs/architecture/ as ADRs — how many depends on…

25k8d 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.