agentleFS

CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Worked for most · soon
cwoodcoxCLAUDE.md

on-record

cwoodcox/on-record/CLAUDE.md

pnpm workspaces monorepo: - apps/web — Next.js 16.1.6 frontend - apps/mcp-server — TypeScript MCP backend (Hono + better-sqlite3) - packages/typescript-config, packages/types — shared packages Key paths: - Planning artifacts: _bmad-output/planning-artifacts/…

08mo agoReviewMountCreate a free account to mount
cwoodcoxReads credentialsCLAUDE.md

ugrc-mcp

cwoodcox/ugrc-mcp/CLAUDE.md

v0.2 (released 2026-05). 33-tool MCP server: 20 SGID list_<category> discovery tools, 3 generic discovery/search tools (list_capabilities, describe_layer, find_layer), 3 query primitives (arcgis_query, arcgis_aggregate, arcgis_raw), and 7 mapserv wrappers. docs/plan.md is the authoritative design doc — read it end-to-end before making non-trivial changes. docs/epic-v0.2.md + docs/stories/* track the rollout. spec.md is the v0.1 contract; superseded by plan.md for tool shapes, but still useful for the geometry/error invariants. The 33-tool surface splits cleanly into discovery and action, layered over three coverage tiers.

06mo agoReviewMountCreate a free account to mount
cwoodcoxCLAUDE.md

utah-water-rights-mcp

cwoodcox/utah-water-rights-mcp/CLAUDE.md

A remote MCP server that wraps the Utah Division of Water Rights' public surfaces and exposes them as 20 read-only tools. Runs stateless on Cloudflare Workers via createMcpHandler from the agents SDK. No auth, no Durable Objects, no KV. Read docs/dwr-reverse-engineering.md before adding tools or probing new endpoints. It's the institutional memory: endpoint catalog, wrDB schema, confirmed-non-existent tables, the WRCHEX-vs-WRNUM gotcha, scanned-doc URL construction, and a decision tree for "where does this data live." The whole server exists to paper…

06mo agoReviewMountCreate a free account to mount
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.