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 46Worked for most · soon
AncienttwoCLAUDE.md

repo-harness / assets

Ancienttwo/repo-harness/assets/CLAUDE.md

Keep this file focused on the local contract for this primary functional block. Owns the workflow-engine-contract-assets capability boundary declared in .archcontext/model/nodes. - bun test tests/workflow-contract.test.ts tests/scaffold-parity.test.ts - bun scripts/capability-resolver.ts validate --format text <!-- END CAPABILITY CONTEXT --> - Durable progress lives under tasks/workstreams/workflow-engine/contract-assets. - tasks/current.md is the ignored local derived status read model; it is not a live lock or task source. - tasks/todos.md is the deferred-goal ledger; current execution slices stay in the active plan's ## Task Breakdown. <!--…

43519d agoDiscuss
AncienttwoCLAUDE.md

repo-harness

Ancienttwo/repo-harness/CLAUDE.md

This repository self-hosts the repo-harness contract; the former repo-harness-skill and project-initializer names have been fully removed and are no longer recognized by any tooling. Claude and Codex should follow the same repo-local workflow surface.

43519d agoDiscuss
AncienttwoCLAUDE.md

repo-harness / evals

Ancienttwo/repo-harness/evals/CLAUDE.md

Keep this file focused on the local contract for this primary functional block.

43519d agoDiscuss
AncienttwoCLAUDE.md

repo-harness / scripts

Ancienttwo/repo-harness/scripts/CLAUDE.md

Keep this file focused on the local contract for this primary functional block. Owns the workflow-engine-inspection-migration capability boundary declared in .archcontext/model/nodes. - bun test tests/migration-script.test.ts tests/create-project-dirs.runtime.test.ts tests/workflow-contract.test.ts - bun src/cli/index.ts init --repo . --dry-run <!-- END CAPABILITY CONTEXT --> - Durable progress lives under tasks/workstreams/workflow-engine/inspection-migration. - tasks/current.md is the ignored local derived status read model; it is not a live lock or task source. - tasks/todos.md is the deferred-goal ledger; current execution slices stay in the active plan's ## Task…

43519d agoDiscuss
JetBrainsCLAUDE.md

youtrackdb

JetBrains/youtrackdb/CLAUDE.md

YouTrackDB is a general-purpose object-oriented graph database developed by JetBrains, used internally in production. It implements the Apache TinkerPop API with Gremlin query language support and features O(1) link traversal, schema-less/mixed/full modes, and encryption at rest. The project is a fork of OrientDB, re-architected under the com.jetbrains.youtrackdb package namespace. JVM memory: .mvn/jvm.config sets -Xmx8192m for Maven itself. Tests use -Xms4096m -Xmx4096m (configurable via heapSize property). Important: Tests require numerous --add-opens JVM flags for Java module system compatibility. These are configured…

4353mo agoDiscuss
Microsoft AzureCLAUDE.md

azure-container-networking

Azure/azure-container-networking/CLAUDE.md

Use all agents.md found from the root to the current directory as instructions and context.

43442d agoDiscuss
GenielabsOpenSourceCLAUDE.md

spine-animation-ai / reskin-app

GenielabsOpenSource/spine-animation-ai/reskin-app/CLAUDE.md

This project uses the Genie Studio design system at design-system/genie-studio/. Never invent colors, type, spacing, or components not grounded in this system. Calm, plain, second-person, sentence case, no emoji, no…

4347mo agoDiscuss
cnighswongerCLAUDE.md

claude-code-cache-fix

cnighswonger/claude-code-cache-fix/CLAUDE.md

All gh writes from this repo run under the vsits-proxy-builder[bot] App identity, never under the operator's personal PAT. This keeps the audit trail clean. The gh-bot-guard.sh PreToolUse hook (in ~/.claude/hooks/)…

4324mo agoDiscuss
Gabson0xCLAUDE.md

bountyforge / pashov

Gabson0x/bountyforge/skills/pashov/CLAUDE.md

Instructions for Claude when contributing to this repository. A library of Claude AI skills. Each skill is a focused, self-contained capability for Claude Code in VS Code and Cursor.

43115d agoDiscuss
alirezarezvaniCLAUDE.md

claude-code-aso-skill

alirezarezvani/claude-code-aso-skill/CLAUDE.md

This is a Claude Code skill repository containing the "app-store-optimization" skill. This skill provides comprehensive ASO capabilities for mobile app developers and marketers to optimize app presence on Apple App…

4305mo agoDiscuss
mimurchisonCLAUDE.md

claude-chief-of-staff

mimurchison/claude-chief-of-staff/CLAUDE.md

This file IS your AI operating system. The more specific you make it, the better Claude performs. Invest time here — it compounds. --> Owner: {{YOUR_NAME}} Role of Claude: Chief-of-Staff-grade productivity, strategy, and learning partner Scope: All domains — work, personal, relationships Claude is expected to push hard, challenge priorities, and optimize for long-term leverage. **Double {{YOUR_NAME}}'s productivity** by ensuring time, attention, and energy are consistently applied to the highest-leverage outcomes, while minimizing distraction, decision drag, and low-value work. Two…

4298mo agoDiscuss
peterfeiCLAUDE.md

ai-agent-team

peterfei/ai-agent-team/.claude/CLAUDE.md

这是最高优先级的规则,必须无条件遵守! 当使用 thread-manager MCP 服务器的任何工具(switchthread、createthread、list_threads 等)时: 每次调用 thread-manager 工具后,必须: - [ ] 从工具返回结果中提取 message 字段 - [ ] 原封不动地输出 message 的完整内容 - [ ] 立即停止输出,不添加任何其他内容 本项目实现了一个专业的AI智能体团队,使用Claude Code的原生智能体系统。每个智能体都根据特定提示词定义,可以通过Claude Code命令直接调用。 为了更方便地使用,您可以使用以下快捷命令: 快捷命令文件位于:.claude/commands/ 目录 每个智能体提示词文件包含:

4294mo agoDiscuss
palkanCLAUDE.md

layered-rails-skills

palkan/layered-rails-skills/CLAUDE.md

Agentic guidance for developing skills in this repo. Skills usage lives in each skill's SKILL.md — this file is for the meta workflow of building and shipping skills. CHANGELOG.md uses…

42830d agoDiscuss
adithyan-akCLAUDE.md

AgentHound

adithyan-ak/AgentHound/CLAUDE.md

AgentHound provides autonomous offensive collection and access verification for AI agent infrastructure. Before committing: Changes spanning collection, planning, artifacts, ingestion, or findings also run make integration. Documentation changes run make docs-check. Before a release tag, run make prerelease and make docs-check. Release tags are numeric SemVer without a v prefix. The first numeric heading in CHANGELOG.md is the version source of truth; make sync-version updates every live installer, environment, and Docker Compose pin in the README, installer, and operator documentation.

4272mo agoDiscuss
joshukraineCLAUDE.md

dotfiles

joshukraine/dotfiles/CLAUDE.md

This is a personal dotfiles repository for macOS using GNU Stow for symlink management. It provides a comprehensive development environment configuration including Zsh shell setup, terminal configurations (ghostty/kitty), and Neovim with LazyVim distribution. The repository is organized with each top-level directory representing a tool or application configuration: This repo overrides the global PR-first default. Small changes — config tweaks, single-line edits, typo/doc touch-ups — are committed directly to master and pushed, no branch or PR. Reserve the branch → PR…

4273mo agoDiscuss
marian2jsCLAUDE.md

opengoat

marian2js/opengoat/CLAUDE.md

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

4278mo agoDiscuss
NgxbaCLAUDE.md

claude-code-cli-ui

Ngxba/claude-code-cli-ui/CLAUDE.md

agents-ui is a Nuxt 3-based visual dashboard for managing Claude Code agents, commands, skills, workflows, and plugins. It provides a GUI layer on top of the ~/.claude directory, allowing users to create, edit, and organize their Claude Code configuration without touching markdown files directly. Pages (app/pages/): - /agents - List and manage agents - /agents/[slug] - Edit individual agent - /commands - List and manage commands - /skills - List and manage skills - /workflows - Visual workflow builder -…

4266mo agoDiscuss
ZingerLittleBeeCLAUDE.md

Heeler

ZingerLittleBee/Heeler/CLAUDE.md

Native iOS companion app for herdr (https://herdr.dev): an agent console over SSH, not a terminal app. Read CONTEXT.md for vocabulary and docs/adr/ before challenging architecture decisions — the transport design in particular was reached after eliminating several dead ends. Rediscovering these is expensive. Each fact retains its evidence version and method (live observation or source review); older observations are not re-tests on a newer release. For 0.9.0 subscription ordering, compatibility evidence, and remaining verification, read the integration review.

42610d agoDiscuss
ChenChenyaqiCLAUDE.md

learn-anything

ChenChenyaqi/learn-anything/CLAUDE.md

Learn Anything is a CLI tool (learn-anything) that generates skill and command files for AI coding assistants, turning them into interactive learning tutors. It supports 30+ AI tools (Claude Code, Cursor, Gemini CLI, Codex, Copilot, Windsurf, etc.) and outputs localized files in en and zh-CN. The generated skills implement 6 learning workflows: topic (initialize a subject), explain (recursive Socratic deep-dive), practice (TDD-style exercises), review (spaced repetition), status (knowledge map visualization), and quiz (two-stage generation and grading).

4254mo agoDiscuss
itechmeatCLAUDE.md

open-second-brain

itechmeat/open-second-brain/CLAUDE.md

Guidance for agents working in this repository. package.json version is the single source of truth. The version is mirrored into several manifests (plugin.yaml, plugins/hermes/plugin.yaml, .claude-plugin/plugin.json, .codex-plugin/plugin.json, plugins/codex/.codex-plugin/plugin.json, openclaw.plugin.json), pyproject.toml and uv.lock. Never hand-edit the version in those mirrored files. To bump the version, edit package.json only, then propagate with: CI gates on bun run scripts/sync-version.ts --check (the validate job, step "Verify manifest version sync"). Hand-editing one file leaves the others drifted and fails that gate before any other check runs.…

4255d 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.