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 35Worked for most · soon
MicrosoftCLAUDE.md

TypeAgent / taskflow

microsoft/TypeAgent/ts/packages/agents/taskflow/CLAUDE.md

TaskFlow runs user-taught multi-step macros over existing TypeAgent actions. Flows are pure JSON — no TypeScript logic. A deterministic compile script handles all boilerplate generation (TypeScript type, grammar rule, manifest entry). When asked to "compile pending recipes" or similar: That's it. scripts/compileRecipes.mjs reads pending/*.recipe.json and: If the build fails, fix the error in the generated files and re-run pnpm run build. When asked to write a recipe for a new flow (or if you notice a missing flow): Do NOT…

7433mo agoDiscuss
stevemolitorCLAUDE.md

claude-code.el

stevemolitor/claude-code.el/CLAUDE.md

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

74318mo agoDiscuss
symgraphCLAUDE.md

GhidrAssistMCP

symgraph/GhidrAssistMCP/CLAUDE.md

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

7323mo agoDiscuss
tech-systemsCLAUDE.md

panes

tech-systems/panes/CLAUDE.md

Cupertino Panes is a TypeScript library that creates multi-functional modals, cards, and panes with touch technologies. It provides native iOS-style behaviors and animations for web applications. Each module can be enabled/disabled through the modules configuration option.

7306y agoDiscuss
tbxarkCLAUDE.md

mcp-proxy

tbxark/mcp-proxy/CLAUDE.md

An MCP proxy server (Go, single main package, flat layout) that aggregates multiple downstream MCP servers behind one HTTP entrypoint. Each configured downstream server is exposed at its own route (<baseURL path>/<serverName>/) via SSE or streamable HTTP. make format expects golangci-lint and nilaway to be installed. Run it (or at least go vet + tests) before considering a change done. Request flow: MCP client → HTTP mux (http.go) → per-server middleware chain (recover, optional logging, optional bearer-token auth) → server.MCPServer…

72813mo agoDiscuss
dbt-labsCLAUDE.md

dbt-agent-skills

dbt-labs/dbt-agent-skills/CLAUDE.md

This repository contains skills for AI agents working with dbt projects. This repo uses the superpowers skill framework. When creating or modifying skills: The superpowers marketplace is configured in .claude/settings.json and will be auto-installed when you trust this repo. Every SKILL.md must have valid frontmatter: Critical Rules: - name MUST be lowercase with hyphens only (letters, digits, hyphens) - name MUST match the directory name exactly - Only allowed fields: name, description, allowed-tools, compatibility, license, metadata, user-invocable - NO version,…

7277mo agoDiscuss
dbt-labsCLAUDE.md

dbt-agent-skills / evals

dbt-labs/dbt-agent-skills/evals/CLAUDE.md

See AGENTS.md for development conventions. Quick reference: - Use typer.echo() for CLI output, logger from logging.py for progress - Run uv run ty check src/ before committing - Add tests for new features - Check dataclasses in models.py and runner.py when modifying commands

7277mo agoDiscuss
hackerai-techCLAUDE.md

hackerai

hackerai-tech/hackerai/CLAUDE.md

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

72717d agoDiscuss
agentic-boxCLAUDE.md

memora

agentic-box/memora/CLAUDE.md

Memora is the sole memory system for this project. Do NOT use Claude Code's built-in auto memory (MEMORY.md). All memory operations must go through Memora MCP tools. Behavior is defined in .claude/skills/memora/SKILL.md.

7266mo agoDiscuss
GarethManningCLAUDE.md

education-agent-skills

GarethManning/education-agent-skills/CLAUDE.md

This feeds the project entity compiler, which runs every 2 hours. If the save doesn't mention the project by name, it won't be compiled into the entity page.

7254mo agoDiscuss
msrbuildsCLAUDE.md

elementor-mcp

msrbuilds/elementor-mcp/CLAUDE.md

All project guidance for coding agents lives in AGENTS.md (single source of truth for Claude Code, Codex, Cursor, Copilot and others). Do not add knowledge here; edit AGENTS.md.

7257mo agoDiscuss
863401402CLAUDE.md

she-love-me

863401402/she-love-me/CLAUDE.md

本仓库提供 she-love-me 聊天关系分析技能。 Claude Code 可使用 /she-love-me 触发。.claude/settings.json 已注册统一技能目录;.claude/skills/she-love-me/SKILL.md 是兼容副本,必须与 .agents/skills/she-love-me/SKILL.md 保持完全一致。

72349d agoDiscuss
kgoedeckeCLAUDE.md

doop

kgoedecke/doop/CLAUDE.md

@.context/INDEX.md This is a placeholder. Will need to be updated. https://github.com/kgoedecke/doop Doop is the open-source alternative to Paper.design: a multiplayer design canvas for humans and AI agents. Every design lives…

72322d agoDiscuss
runesleoCLAUDE.md

claude-code-workflow

runesleo/claude-code-workflow/CLAUDE.md

Project instructions live in AGENTS.md. The installable personal template is under templates/.

71133d agoDiscuss
marckohlbruggeCLAUDE.md

37signals-skills

marckohlbrugge/37signals-skills/CLAUDE.md

This repository packages 37signals' Rails patterns in two forms: There is no application code, build system, or tests. When editing or adding content: - Focus on transferable patterns, not Fizzy-specific…

7104mo agoDiscuss
petersCLAUDE.md

horizon

peters/horizon/CLAUDE.md

See AGENTS.md for all project guidelines and conventions.

7105d agoDiscuss
alinaqiCLAUDE.md

maggy

alinaqi/maggy/CLAUDE.md

- Write clear, concise commit messages - One logical change per commit - Run tests before committing - Update CHANGELOG.md in the same commit — every behaviour/config/docs/deps change ships a changelog entry (see rules/changelog.md). No commit without one. ALWAYS write tests before implementation. No exceptions. If asked to add a feature without tests, write the tests first then ask to proceed. If a PR diff shows untested code paths, flag them before continuing. Invoke: qwen3 "" Invoke: gemini --flash-lite ""

7074mo agoDiscuss
trailofbitsCLAUDE.md

coop

trailofbits/coop/CLAUDE.md

Follow the shared repository instructions in AGENTS.md. Agent workflows are in .agents/skills/; compatibility commands under .claude/commands/ invoke those workflows. Shared entrypoint for Claude, Codex, and humans. Keep this short and navigational; durable detail lives in docs/. - docs/index.md — system-of-record map. - docs/ARCHITECTURE.md — module map, the two-backend design, host→guest data flow, architectural invariants. - docs/trust-model.md — trust boundaries and taint sources (the security spec; read before touching secrets, subprocess, network, or the guest boundary). - docs/code-style.md — Rust authoring…

70428d agoDiscuss
gmickelCLAUDE.md

flow-next

gmickel/flow-next/CLAUDE.md

Read the shared development policy before repository work. It owns architecture, source ownership, verification, and delivery rules. This file owns host guidance only; keep common rules in that policy. Canonical spec scaffold: templates/spec.md. For skill/platform changes also read cross-platform patterns. On Claude Code, invoke skills by skill id, flow-next:flow-next-<name>; the /flow-next:<name> commands are typed by the user and hidden from the model. Other consumers of this file use their supported native equivalent. Distinguish Claude-native product source examples from the tools…

7033d agoDiscuss
gmickelCLAUDE.md

flow-next / flow-next-tui

gmickel/flow-next/flow-next-tui/CLAUDE.md

Terminal UI for flow-next Ralph mode. Real-time visibility into autonomous agent runs. Components we use:

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