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 15Worked for most · soon
simonlin1212CLAUDE.md

TradingAgents-astock

simonlin1212/TradingAgents-astock/CLAUDE.md

- 仓库: https://github.com/simonlin1212/TradingAgents-astock - 协议: Apache 2.0 - Python: >=3.10 - 当前版本: 0.5.20(2026-09-21) ⚠️ 改版本号时三处要一起改:pyproject.toml / CHANGELOG.md / 这一行。漏了这行会让后续 agent 和发版流程读到旧版本(tests/testversionconsistency.py 会拦)。 v0.3.1 起 [google] extra 已移除(#87):uv 构建覆盖所有 extra 的 universal lock,extra 存在就让所有人的 uv sync 失败。留空更糟(pip install .[google] 静默装空)。需要 Gemini 时显式装 pip install --no-deps "langchain-google-genai>=4.0.0" + pip install "google-genai>=1.53.0" "httpx>=0.28.1";google_client.py 导入失败会打印这两条命令。⚠️ 新增依赖后务必跑 uv lock --dry-run 验证——pip 能装通不代表 uv 能锁。 ⚠️ v0.5.3 曾声称"一个卡点覆盖 15 个接口",实际漏了 3 个(龙虎榜/解禁/行业对比直接 调了 safetickercomponent),拿 00700 调用会返回"近30日未上龙虎榜"这种看起来完全 正常的报告。v0.5.5 补全。改完这类防护要枚举所有 vendor 逐个实测,别从设计推断覆盖面。

3.6k10d agoDiscuss
JetBrainsCLAUDE.md

kotlinconf-app

JetBrains/kotlinconf-app/CLAUDE.md

The official KotlinConf app — a Kotlin Multiplatform project serving Android, iOS, JVM desktop, and WebAssembly clients, backed by a Ktor server. All client UI is shared via Compose Multiplatform. Android uses the app.androidApp run configuration in IDE; iOS uses KotlinConfAppScheme. Dependency Injection — Metro The app uses Metro (not Koin) for DI on the client. Key interfaces: ViewModels are registered into Metro's map multibinding: ConferenceService ConferenceService is the central app singleton. It: - Fetches AppConfig (current year) from the…

3.6k3mo agoDiscuss
NVIDIACLAUDE.md

TransformerEngine

NVIDIA/TransformerEngine/CLAUDE.md

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

3.6k7d agoDiscuss
graykodeCLAUDE.md

abtop

graykode/abtop/CLAUDE.md

Claude-specific instructions are kept in AGENTS.md.

3.5k6mo agoDiscuss
AWSCLAUDE.md

agentcore-samples / claude-code

awslabs/agentcore-samples/01-features/02-host-your-agent/01-runtime/04-coding-agents/03-code-agents-competition-e2e/coding_agents/claude-code/CLAUDE.md

You are a coding agent running on AWS Bedrock AgentCore. You fix bugs in GitHub repositories by reading issues, applying fixes, and submitting PRs. You have a gateway MCP server connected that provides GitHub tools (prefixed mcpgatewayGitHubMCP_). Use them directly — no manual HTTP calls needed. When given a prompt, act immediately: 1. Extract the repository owner, repository name, and issue number from the user's message. 2. Use the MCP tools to read the issue, fix the code, and submit…

3.4k4mo agoDiscuss
RunMaestroCLAUDE.md

Maestro

RunMaestro/Maestro/CLAUDE.md

Essential guidance for working with this codebase. For detailed architecture, see ARCHITECTURE.md. For development setup and processes, see CONTRIBUTING.md. This guide has been split into focused sub-documents for progressive disclosure:

3.4k50d agoDiscuss
MicrosoftCLAUDE.md

Power-Fx

microsoft/Power-Fx/CLAUDE.md

Power Fx is a low-code general-purpose programming language based on spreadsheet-like formulas. This is the open-source C# implementation used across Microsoft Power Platform. The codebase contains a complete compiler and interpreter. Build configurations: Debug/Release (single-target), Debug462/Release462 (net462 only), Debug70/Release70 (net7.0 only), DebugAll/ReleaseAll (multi-target, used by local build scripts). Separation of Compilation and Execution: Core compiles to IR with zero evaluation code. Multiple backends (JavaScript, SQL, etc.) can consume the same IR independently. Symbol Table Composition: Layered symbol tables (Config ->…

3.4k4mo agoDiscuss
MicrosoftCLAUDE.md

Power-Fx / src

microsoft/Power-Fx/src/CLAUDE.md

Power Fx is a low-code general-purpose programming language based on spreadsheet-like formulas. This is the open-source implementation of the language used across Microsoft Power Platform. The codebase contains a complete compiler and interpreter infrastructure written in C#. Note: The runLocalTests.cmd script runs tests for both .NET Framework 4.6.2 and .NET 7.0 configurations using VSTest. The Power Fx implementation follows a classic multi-phase compiler architecture: Expression Text → [Lexer] → Tokens → [Parser] → AST → [Binder] → Typed AST →…

3.4k4mo agoDiscuss
himself65CLAUDE.md

finance-skills

himself65/finance-skills/CLAUDE.md

A collection of agent skills for financial analysis and trading, following the Agent Skills open standard. Skills are installable into Claude Code, Claude.ai, and other supported agents (Codex, Gemini CLI, GitHub Copilot, etc.). This repo is three things at once: 1. A Claude Code plugin marketplace (.claude-plugin/marketplace.json + plugins/) 2. An Agent Skills repository (the SKILL.md files inside plugins/<group>/skills/) 3. An opencli plugin monorepo (opencli-plugin.json at root + opencli-plugins/) — Node code for adapters that some skills depend on Skills…

3.3k56d agoDiscuss
nicedreamzappCLAUDE.md

claude-code-local / NarrativeGemma

nicedreamzapp/claude-code-local/NarrativeGemma/CLAUDE.md

What this is: A Claude Code project persona that makes a local model (Gemma 4 31B in our setup, but works with any) speak every reply out loud through your speakers — using your own cloned voice if you have one, or macOS say as a fallback. Pair it with the Narrative Gemma.command launcher. Before EVERY response, you MUST run this command: Then write your text reply. Speaking is not optional. Speaking is not occasional. Speaking is every single turn,…

3.3k12d agoDiscuss
giancarloerraCLAUDE.md

SocratiCode

giancarloerra/SocratiCode/CLAUDE.md

This project is indexed with SocratiCode. Always use its MCP tools to explore the codebase before reading any files directly. 1. **Start most explorations with codebase_search.* Hybrid semantic + keyword…

3.3k7mo agoDiscuss
samberCLAUDE.md

cc-skills-golang

samber/cc-skills-golang/CLAUDE.md

This is a Claude Code plugin containing AI agent skills for production-ready Go projects. The repository provides reusable skill definitions that Claude Code can invoke when working on Go codebases. Facts in CLAUDE.md, procedures in skills. Repository-wide facts, conventions and constraints live here; step-by-step instructions for a technique or library live in a skill body. Duplicating one in the other produces two sources of truth that drift and eventually contradict each other — the same failure Atomic skills and deduplication…

3.3k42d agoPipes a download into a shellDiscuss
taishi-iCLAUDE.md

awesome-ChatGPT-repositories

taishi-i/awesome-ChatGPT-repositories/CLAUDE.md

This repository is a curated list of 2500+ open-source GitHub repositories related to ChatGPT and LLMs. It includes a searchable skill that Claude Code and Codex share. skills/search/SKILL.md is read by both tools, so keep it agent-neutral: don't rely on $ARGUMENTS (Claude Code appends ARGUMENTS: … on its own), and keep the per-tool lines for locating data/ (${CLAUDEPLUGINROOT}/data for Claude Code, relative to the SKILL.md for Codex). Keep the version in both plugin manifests in sync. After installation, invoke as:

3.3k12d agoDiscuss
liaohch3CLAUDE.md

claude-tap

liaohch3/claude-tap/.claude/CLAUDE.md

This repository uses a single source of truth for engineering rules: Skill layout for multi-agent compatibility: Do not duplicate policy text in this file. Keep all normative rules in AGENTS.md.

3.2k37d agoDiscuss
cortex-docsCLAUDE.md

cortex

cortex-docs/cortex/CLAUDE.md

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

3.2k39d agoDiscuss
samuelgurskyCLAUDE.md

davinci-resolve-mcp

samuelgursky/davinci-resolve-mcp/CLAUDE.md

This file is intentionally short. The canonical AI-agent instructions for this repository live in AGENTS.md. Claude Code users should follow: - AGENTS.md for repository rules and source media safety - docs/SKILL.md for DaVinci Resolve MCP operating guidance - docs/process/release-process.md for version bumps, validation, tags, and GitHub Releases - docs/guides/media-analysis-guide.md for source-safe media analysis Do not maintain a separate release checklist, tool-count summary, or changelog here. Those details drift; use the docs above as the source of truth.

3.2k30d agoDiscuss
punitaraniCLAUDE.md

fli

punitarani/fli/CLAUDE.md

Fli is a Python library that provides programmatic access to Google Flights data through direct API interaction (reverse engineering). The project consists of:

3.2k11d agoDiscuss
stravuCLAUDE.md

crystal

stravu/crystal/CLAUDE.md

Created by Stravu Crystal is a fully-implemented Electron desktop application for managing multiple AI code assistant instances (Claude Code and Codex) against a single directory using git worktrees. It provides a streamlined interface for running parallel AI assistant sessions with different approaches to the same problem. All core features have been successfully implemented with significant enhancements beyond the original requirements.

3.1k12mo agoDiscuss
SynkraAICLAUDE.md

aiox-core

SynkraAI/aiox-core/.claude/CLAUDE.md

Este arquivo configura o comportamento do Claude Code ao trabalhar neste repositório. O AIOX possui uma Constitution formal com princípios inegociáveis e gates automáticos. Documento completo: .aiox-core/constitution.md Princípios fundamentais: Gates…

3.1k4mo 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.