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 8Worked for most · soon
AnthropicCLAUDE.md

claude-quickstarts / copilot-kit-ag-ui

anthropics/claude-quickstarts/managed-agents/copilot-kit-ag-ui/CLAUDE.md

A finance assistant chat app wiring a Claude Managed Agent to CopilotKit's self-hosted runtime over the AG-UI protocol. This file is the technical map: architecture, where the code is, design notes, and how to walk a user through setup. Four pieces:

18k8d agoReads credentialsDiscuss
AnthropicCLAUDE.md

claude-quickstarts / daily-brief

anthropics/claude-quickstarts/managed-agents/daily-brief/CLAUDE.md

A scheduled deployment, not an app: there is no long-running process in this quickstart. agents/daily-brief/ holds six resource files that ant apply reconciles (agent, environment, two memory stores, vault, deployment). ant apply manages the vault container but never its contents, so agents/setup.sh adds the two credentials with ant beta:vaults:credentials create and writes the vault's ID into deployment.md's vaultids (a deployment takes vault IDs, not a file reference). Each scheduled run is a fresh session: it reads /mnt/memory/preferences/preferences.md (read-only store), reads…

18k8d agoReads credentialsDiscuss
AnthropicCLAUDE.md

claude-quickstarts / knowledge-wiki

anthropics/claude-quickstarts/managed-agents/knowledge-wiki/CLAUDE.md

This directory is a Managed Agents cookbook: it builds a real M&A data room into a knowledge wiki (a versioned memory store) and queries it. The runnable artifact is distilldocumentsintoknowledgewiki.ipynb; everything else exists to set that notebook up. When a user asks you to walk them through setting this quickstart up, read skill.md in this directory and follow it step by step. Do not improvise the setup — the SDK build, the SEC user-agent, and the fetch order all matter.

18k8d agoDiscuss
AnthropicCLAUDE.md

claude-quickstarts / linear

anthropics/claude-quickstarts/managed-agents/linear/CLAUDE.md

Stateless webhook bridge: Linear AgentSessionEvent → Managed Agents session (with routing metadata) → session.status_idled webhook → createAgentActivity reply. Pull exact shapes from the /claude-api skill's shared/managed-agents-*.md docs. Run the server with bun run dev. Agent provisioning is ant apply --yes agents environments from this directory (ant 1.30 or later; name the directories rather than ., and pass --yes because you have no terminal for its confirmation prompt, or --dry-run to show the plan first): it creates the agent and environment…

18k8d agoReads credentialsDiscuss
AnthropicCLAUDE.md

claude-quickstarts / mcp-server-typescript

anthropics/claude-quickstarts/managed-agents/mcp-server-typescript/CLAUDE.md

MCP server that exposes Managed Agents session primitives as tools. Two entrypoints sharing one tool set: src/server.ts (stdio → Claude Desktop and Claude Code) and src/server-http.ts (Streamable HTTP → claude.ai custom connector). This quickstart creates no agents, so there is no agents/ directory. It needs one environment, created once from environment.yaml (the command is in that file and in README.md). Commands: bun run stdio (Desktop, Code), bun run http (claude.ai), bun run typecheck.

18k8d agoDiscuss
AnthropicCLAUDE.md

claude-quickstarts / roadtrip-planner

anthropics/claude-quickstarts/managed-agents/roadtrip-planner/CLAUDE.md

A Next.js chat built directly on a Managed Agent session: no chat framework, the event log is the app state. Teaches session event streaming (eventdeltas), vault credential injectionlocation, per-session agentwithoverrides, and multiagent coordinator rosters. The planner calls the National Park Service and Windy APIs with keys it never holds, then hands its draft to a second agent for a quick critique. That second agent is an Opus reviewer running as a session thread. 1. Invoke /claude-api first. It loads the…

18k8d agoDiscuss
AnthropicCLAUDE.md

claude-quickstarts / self-hosted-sandboxes

anthropics/claude-quickstarts/managed-agents/self-hosted-sandboxes/CLAUDE.md

This file is the runbook for the three poller demos, docker/, docker-memory/, and archil/. The five webhook-started providers (cloudflare-containers/, cloudflare-worker/, daytona/, modal/, vercel/) share one agent and one environment, declared in webhook-demo/ and created with ant apply --yes . from that directory. Never run ant apply from this directory: it walks into the poller demos and creates their resources too, and the claude-lock.json it leaves here is then found first by every directory below. Each provider's README is its own…

18k8d agoReads credentialsDiscuss
AnthropicCLAUDE.md

claude-quickstarts / sentry

anthropics/claude-quickstarts/managed-agents/sentry/CLAUDE.md

Scheduled deployment: cron → Managed Agents session with sentry-cli and a vault env-var credential → triage report in /mnt/session/outputs/. Pull exact shapes from the /claude-api skill's shared/managed-agents-*.md docs. Provisioning is ./agents/setup.sh (ant 1.34 or later, jq): it runs ant apply --yes agents environments vaults, which creates the agent, environment, and vault from those directories and records their IDs in claude-lock.json, then adds the Sentry token to the vault as an environmentvariable credential (skipped when the vault already has one), and…

18k8d agoDiscuss
AnthropicCLAUDE.md

claude-quickstarts / slack

anthropics/claude-quickstarts/managed-agents/slack/CLAUDE.md

Stateless webhook bridge: Slack appmention → Managed Agents session (with routing metadata) → session.statusidled webhook → chat.postMessage in-thread. Pull exact shapes from the /claude-api skill's shared/managed-agents-*.md docs. Run the server with bun run dev. Agent provisioning is ant apply --yes agents environments from this directory (ant 1.30 or later; name the directories rather than ., and pass --yes because you have no terminal for its confirmation prompt, or --dry-run to show the plan first): it creates the agent and environment…

18k8d agoReads credentialsDiscuss
LangChainCLAUDE.md

openwiki

langchain-ai/openwiki/CLAUDE.md

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

17k7d agoDiscuss
xbtlinCLAUDE.md

ai-berkshire

xbtlin/ai-berkshire/CLAUDE.md

基于 Claude Code 的价值投资研究 Skill 合集。四大师框架:巴菲特、芒格、段永平、李录。 GitHub: xbtlin/ai-berkshire 所有报告按公司名建文件夹,公司相关的所有报告放在对应文件夹内: - 市值必须手算校验:股价 × 总股本,与报告市值对比 - 货币单位要明确(港币/人民币/美元/新台币),防止混淆 - PE/ROE等指标用 tools/financialrigor.py 精确计算 - 台股数据用 tools/twstockdata.py(FinMind)获取,并按 skills/financial-data.md 台股章节交叉验证 - 报告写完后主动询问是否推送到GitHub - **推送前必须跑 python3 tools/reports_index.py 刷新索引**,否则 CI 的索引校验会失败 - 新报告文件名带 -YYYYMMDD 后缀、正文首行写 # 标题,索引即可自动识别; 需要覆盖时在文件头加 YAML front-matter(title / date / type), 规范见 reports/_index/README.md - 新建的专题目录或筛选池目录要登记进 reports/_index/config.json,否则会被当成公司

17k3mo agoDiscuss
triggerdotdevCLAUDE.md

trigger.dev

triggerdotdev/trigger.dev/docs/CLAUDE.md

Mintlify-based documentation site for Trigger.dev. Pages are MDX files. Frontmatter format: Use these components for structured content:

16k50d agoDiscuss
ag-ui-protocolCLAUDE.md

ag-ui

ag-ui-protocol/ag-ui/CLAUDE.md

For requests to add A2UI rendering to AG-UI applications or to scaffold an AG-UI + A2UI quickstart, use skills/ag-ui-a2ui-integration/SKILL.md. AG-UI is an event-based protocol that standardizes agent-user interactions. The codebase is organized as a monorepo with the following structure:

16k7mo agoDiscuss
xpzouyingCLAUDE.md

xiaohongshu-mcp

xpzouying/xiaohongshu-mcp/CLAUDE.md

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

16k49d agoDiscuss
img2threejsCLAUDE.md

img2threejs

img2threejs/img2threejs/CLAUDE.md

This repository is the canonical source for the img2threejs skill. Host entrypoints (~/.claude/skills/img2threejs, ~/.codex/skills/img2threejs) should be symlinks to one checkout — never independent copies, or the two hosts drift apart silently. - Preserve the code-only procedural Three.js contract; do not silently download meshes or art packs. - Keep claims honest: distinguish implemented capability from roadmap or design-only documentation. - Treat forge/ as deterministic tooling and grimoire/ as routed reference material. - Keep backward compatibility for existing sculpt specs unless a…

16k2mo agoDiscuss
chenhg5CLAUDE.md

cc-connect

chenhg5/cc-connect/CLAUDE.md

CC-Connect is a bridge that connects AI coding agents (Claude Code, Codex, Gemini CLI, Cursor, etc.) with messaging platforms (Feishu/Lark, Telegram, Discord, Slack, DingTalk, WeChat Work, QQ, LINE). Users interact…

16k7mo agoDiscuss
open-metadataCLAUDE.md

OpenMetadata

open-metadata/OpenMetadata/CLAUDE.md

Always-loaded guidance for every session. *Language- and path-specific rules live in .claude/rules/.md (auto-loaded when you touch matching files); procedures live in skills (loaded on invoke).* This file is the map — see the pointer index at the bottom. Read ARCHITECTURE.md for the *system map* (modules, the request/ingestion/search paths, the invariants that hold); read DEVELOPER.md for *how to build, test, and add an entity or connector* (deep dives + end-to-end checklists). Consult docs/index.md — the *knowledge index* — to *find existing…

15k29d agoDiscuss
open-metadataCLAUDE.md

OpenMetadata / openmetadata-ui-core-components

open-metadata/OpenMetadata/openmetadata-ui-core-components/CLAUDE.md

Shared UI component library for OpenMetadata, built on UntitledUI design system patterns with React Aria Components as the accessibility foundation. All public components must be exported from src/components/index.ts. Add new exports there when creating components. All Tailwind classes use the tw: prefix: tw:flex, tw:bg-primary, tw:text-sm, etc. This is mandatory to scope styles and prevent collisions with the main app's existing Less/Ant Design CSS. Theme colors are defined as CSS custom properties in src/styles/globals.css with light and dark mode variant

15k29d agoDiscuss
MicrosoftCLAUDE.md

playwright-python

microsoft/playwright-python/CLAUDE.md

Guidance for Claude when working in this repository. Python bindings for Playwright. The Python client talks JSON over a pipe to the Node-based driver bundled in playwright/driver/. The pipe protocol is defined upstream in packages/protocol/src/protocol.yml. CONTRIBUTING.md has the full sequence. The short version (needs Node.js and npm for the driver build): If the system lacks python3-venv, uv venv env is an acceptable substitute (then uv pip install --python env/bin/python --upgrade pip). When changing public API, edit impl/, then run ./scripts/updateapi.sh.…

15k3mo agoDiscuss
yusufkaraaslanCLAUDE.md

Skill_Seekers

yusufkaraaslan/Skill_Seekers/CLAUDE.md

Skill Seekers converts documentation from 18 source types into production-ready formats for 21+ AI platforms (LLM platforms, RAG frameworks, vector databases, AI coding assistants). Published on PyPI as skill-seekers. Version: 3.9.0 (dev; last release 3.8.0) — source of truth is src/skillseekers/version.py | Python: 3.10+ | Website: https://skillseekersweb.com/ Architecture: See docs/UMLARCHITECTURE.md for UML diagrams and module overview. StarUML project at docs/UML/skillseekers.mdj. Refactor state/history: docs/UNIFICATION_PLAN.md (Grand Unification — all 5 phases done; remaining cosmetic items listed there). Runs on push/PR to main…

15k12mo agoReads credentialsDiscuss
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.