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 7Worked for most · soon

10k+ stars

coleam00CLAUDE.md

Archon

coleam00/Archon/CLAUDE.md

Agent rules: read @AGENTS.md

24k2mo agoDiscuss

microCLAUDE.md

Go Micro is a framework for distributed systems development in Go. It provides pluggable abstractions for service discovery, RPC, pub/sub, config, auth, storage, and more. The framework is evolving into an AI-native platform where every microservice is automatically accessible to AI agents via the Model Context Protocol (MCP).

23k3mo agoDiscuss

czlonkowskiCLAUDE.md

n8n-mcp

czlonkowski/n8n-mcp/CLAUDE.md

Note: This file is committed to a public OSS repository. Never add sensitive information (API keys, internal URLs, credentials, private infrastructure details) here. n8n-mcp is an MCP (Model Context Protocol) server that gives AI assistants access to n8n node documentation, workflow validation, and workflow management. Documentation and validation tools work offline against a bundled SQLite database of node information; management tools (n8n_*) operate on a live n8n instance when API credentials are configured. Key subsystems of src/ (non-exhaustive — smaller…

23k33d agoDiscuss

1Panel-devCLAUDE.md

MaxKB

1Panel-dev/MaxKB/CLAUDE.md

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

23k22mo agoDiscuss

claude-code-bestCLAUDE.md

claude-code

claude-code-best/claude-code/CLAUDE.md

This is a reverse-engineered / decompiled version of Anthropic's official Claude Code CLI tool. The goal is to restore core functionality while trimming secondary capabilities. Many modules are stubbed or…

22k6mo agoReads credentialsDiscuss

vxcontrolCLAUDE.md

pentagi

vxcontrol/pentagi/CLAUDE.md

PentAGI is an automated security testing platform powered by AI agents. It runs autonomous penetration testing workflows using a multi-agent system (Researcher, Developer, Executor agents) that coordinates LLM providers, Docker-sandboxed tool execution, and a persistent vector memory store. The application is a monorepo with: - backend/ — Go REST + GraphQL API server - frontend/ — React + TypeScript web UI - observability/ — Optional monitoring stack configs The full stack runs at https://localhost:8443 when using Docker Compose. Copy .env.example…

22k6mo agoReads credentialsDiscuss

steipeteCLAUDE.md

CodexBar

steipete/CodexBar/docs/claude.md

Claude supports three usage data paths plus local cost usage. The main provider pipeline uses runtime-specific automatic selection, but the codebase still has multiple active Claude .auto decision sites while the refactor is pending. For the exact current-state parity contract, see docs/refactor/claude-current-baseline.md. When an Anthropic Admin API key is configured, Claude can also show organization-level spend/messages/tokens in the same inline dashboard pattern used by the OpenAI API provider. Incomplete proxy records with an explicit null stop_reason, positive input, zero output,…

22k4mo agoReads credentialsDiscuss

ElasticCLAUDE.md

kibana

elastic/kibana/.claude/CLAUDE.md

../AGENTS.md

21k3mo agoDiscuss

GoogleCLAUDE.md

skills / refresh

google/skills/skills/cloud/firebase-basics/references/refresh/claude.md

Follow these steps to refresh Claude Code's local environment, ensuring that their agent skills and plugins are fully up-to-date. Use Claude Code's native plugin manager instead of npx. 1. Update the Plugin: Run the specific CLI command to update the Firebase plugin:

20k10d agoDiscuss

1jehuangCLAUDE.md

jcode

1jehuang/jcode/CLAUDE.md

Follow AGENTS.md for the development workflow and CONTRIBUTING.md for the contribution policy. Pull requests from everyone are welcome for direct review and merging, regardless of contributor or maintainer status. Preserve unrelated work and obtain user authorization before merging.

20k41d agoDiscuss

teng-linCLAUDE.md

notebooklm-py

teng-lin/notebooklm-py/CLAUDE.md

Guidance for Claude Code working in this repository. Follow conventions in CONTRIBUTING.md. notebooklm-py is an unofficial async Python client for Google NotebookLM, driving Google's internal batchexecute RPC protocol to automate notebooks, sources, chat, and studio artifacts. Critical constraint: Obfuscated RPC method IDs in src/notebooklm/rpc/_identifiers.py are undocumented and Google changes them periodically — the #1 breakage class. rpc/types.py re-exports them for backwards compatibility. See docs/installation.md for the full installation guide. Always install the full extras set (mcp, server, impersonate); omitting them…

20k29d agoDiscuss

getpaseoCLAUDE.md

paseo

getpaseo/paseo/CLAUDE.md

Paseo is a mobile app for monitoring and controlling your local AI coding agents from anywhere. Your dev environment, in your pocket. Connects directly to your actual development environment —…

19k54d agoDiscuss

emcie-coCLAUDE.md

parlant

emcie-co/parlant/CLAUDE.md

This is the main repo of Parlant (https://parlant.io). Parlant is a Python based agent framework. Its core strengths: The repo's structure follows the Hexagonal Architecture (Ports and Adapters) approach. General Coding Instructions: Always follow this plan when asked to code a feature or fix a bug: 1. Consider the codebase's structure 2. Describe your implementation plan, including: a. What tests you will write (test names + files they would live in) b. Why do you think the tests would initially…

18k21mo agoDiscuss

RightNow-AICLAUDE.md

openfang

RightNow-AI/openfang/CLAUDE.md

The daemon command is start (not daemon).

18k7mo agoReads credentialsDiscuss

muratcankoylanCLAUDE.md

Agent-Skills-for-Context-Engineering

muratcankoylan/Agent-Skills-for-Context-Engineering/CLAUDE.md

Agent Skills for Context Engineering is an open collection of Agent Skills teaching context engineering and harness engineering principles for production AI agent systems. Skills are platform-agnostic (Claude Code, Cursor, Codex/OpenAI Agent Skills, GitHub Copilot, any Open Plugins-conformant tool). v2.5.0 adds the long-horizon-prompting skill (pseudo-formal task briefs for long-running autonomous agents and parallel orchestrations) on top of the self-improvement-loops skill (v2.4.0) and the file-based researcher operating system with deterministic gates, cross-platform Agent Skills validation, and a continuous loop. Use the…

18k52d agoDiscuss

AgriciDanielCLAUDE.md

claude-seo

AgriciDaniel/claude-seo/CLAUDE.md

This repository contains Claude SEO, a Tier 4 Claude Code skill for comprehensive SEO analysis across all industries. It follows the Agent Skills open standard and the 3-layer architecture (directive, orchestration, execution). 26 sub-skills (22 core + 1 orchestrator + 1 framework integration + 2 extension mirrors), 19 sub-agents (16 core + 1 framework integration + 2 extension mirrors), and an extensible reference system cover technical SEO, content quality, schema markup, image optimization, sitemap architecture, AI search optimization, local SEO…

18k4mo agoReads credentialsDiscuss

CannerCLAUDE.md

WrenAI

Canner/WrenAI/.claude/CLAUDE.md

Wren is an open-source semantic engine for MCP clients and AI agents. It translates SQL queries through a semantic layer (MDL — Modeling Definition Language) and executes them against 22+…

18k21mo agoDiscuss

AnthropicCLAUDE.md

claude-quickstarts

anthropics/claude-quickstarts/CLAUDE.md

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

18k8d agoReads credentialsDiscuss

AnthropicCLAUDE.md

claude-quickstarts / assistant-ui

anthropics/claude-quickstarts/managed-agents/assistant-ui/CLAUDE.md

A Next.js chat app. assistant-ui renders everything; one Managed Agents session per conversation runs the analyst, and lib/managed-agents/reducer.ts folds each session's event log into the messages assistant-ui renders. The sidebar is the session list. There is no database. Needs Node 22+, @anthropic-ai/sdk 0.109.0 or later (event_deltas + session event helpers), and @assistant-ui/react 0.14.27 or later (the defineToolkit/Tools API and approvals on useExternalStoreRuntime). Pull exact shapes from the /claude-api skill's shared/managed-agents-*.md docs.

18k8d agoReads credentialsDiscuss

AnthropicCLAUDE.md

claude-quickstarts / chat-sdk

anthropics/claude-quickstarts/managed-agents/chat-sdk/CLAUDE.md

Long-running Node server (Hono): browser chat with a sessions sidebar (useChat → /api/chat) → Chat SDK web adapter onDirectMessage → one Managed Agents session per conversation, where the conversation ID is the session ID (no mapping, no database; the sidebar is sessions.list, transcript replay is sessions.events.list) → a held session event stream (opened with event_deltas token previews, always on) feeds each fragment back onto the same HTTP response while /api/activity streams the tool calls and thinking the page shows as…

18k8d 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.