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

Hiding risky files

MongoDBCLAUDE.md

kingfisher

mongodb/kingfisher/CLAUDE.md

IMPORTANT: Read and follow all instructions in AGENTS.md before starting any task.

1.2k8d agoDiscuss

SupabaseCLAUDE.md

postgres-meta is a RESTful API for managing PostgreSQL databases. It provides a normalized interface over the PostgreSQL system catalog, exposing database objects (tables, columns, functions, etc.) through a Fastify-based REST API. The library can be used both as a standalone server and as an npm package. The dev server uses nodemon with ts-node/esm loader and pipes output through pino-pretty for readable logs. Build process: TypeScript compilation (tsc) + copying src/lib/sql/*.sql files to dist/lib/sql/ via cpy-cli. Tests use Vitest with snapshot…

1.2k31d agoDiscuss

Taewan-PCLAUDE.md

gpt_mobile

Taewan-P/gpt_mobile/CLAUDE.md

GPT Mobile is an Android chat application that supports chatting with multiple AI models simultaneously (OpenAI GPT, Anthropic Claude, Google Gemini, Groq, and Ollama). Built with 100% Kotlin, Jetpack Compose,…

1.2k20mo agoDiscuss

daaainCLAUDE.md

claude-code-log

daaain/claude-code-log/CLAUDE.md

A Python CLI tool that converts Claude Code transcript JSONL files into readable HTML format. This tool processes Claude Code transcript files (stored as JSONL) and generates clean, minimalist HTML pages with comprehensive session navigation and token usage tracking. It's designed to create a readable log of your Claude interactions with rich metadata and easy navigation. Output Files Generated: - ~/.claude/projects/index.html - Master index with project cards - ~/.claude/projects/project-name/combined_transcripts.html - Combined project page - ~/.claude/projects/project-name/session-{id}.html - Individual session pages See…

1.2k32d agoDiscuss

hoangnb24CLAUDE.md

repository-harness

hoangnb24/repository-harness/CLAUDE.md

Claude Code does not auto-load AGENTS.md. Import that single canonical project instruction source. Keep this bare @ line outside backticks so the import remains active. @AGENTS.md

1.2k51d agoDiscuss

modu-aiCLAUDE.md

moai-adk

modu-ai/moai-adk/CLAUDE.md

The clauses binding every turn regardless of harness live in the root AGENTS.md, imported below through the same @-mechanism §9 uses. This file adds only the Claude-mechanism layer on top of it — the question channel, deferred-tool preload, subagent backgrounding — never a second inline copy. You are Master Agent MoAI — the master orchestrator whose mission is the user's successful agentic coding. MoAI is the Strategic Orchestrator for Claude Code. All tasks must be delegated to specialized agents. [ZONE]…

1.2k36d agoDiscuss

adamlyttleappsCLAUDE.md

claude-skill-app-onboarding-questionnaire

adamlyttleapps/claude-skill-app-onboarding-questionnaire/CLAUDE.md

A Claude Code skill (app-onboarding-questionnaire) that designs and builds high-converting questionnaire-style onboarding flows for any app. Modelled on proven conversion patterns from top subscription apps (Mob, Headspace, Noom, Duolingo). Invoked via /app-onboarding-questionnaire from within a user's app project. The skill implements a 13-screen archetype sequence based on the Mob recipe app's onboarding (the gold standard reference). The psychological sequence is: Not every app needs every screen — the skill adapts based on complexity.

1.2k6mo agoDiscuss

FranciscoMorettiCLAUDE.md

chat-js

FranciscoMoretti/chat-js/CLAUDE.md

Before changing any component, page, or styles, read the making-ui-changes skill and follow it - reuse before you create, add/update the story or capture in the same change, check the blast radius on shared components, and prove the change with a visual test.

1.2k19d agoDiscuss

alookaiCLAUDE.md

alook

alookai/alook/CLAUDE.md

read @AGENTS.md

1.2k18d agoDiscuss

MicrosoftCLAUDE.md

skills-for-fabric

microsoft/skills-for-fabric/CLAUDE.md

Updates: fabric-collection is a third-party marketplace, so enable auto-update once: run /plugin, open Marketplaces, select fabric-collection, and choose Enable auto-update. Administrators can instead set "autoUpdate": true on its extraKnownMarketplaces entry in managed settings. To update on demand, run claude plugin update <plugin>@fabric-collection. If these files were copied in loosely rather than installed as a plugin, compare the local package.json version against the remote (git fetch origin main --quiet && git show origin/main:package.json) and re-copy if it is newer. This project…

1.2k7d agoDiscuss

brycewang-stanfordCLAUDE.md

Awesome-Journal-Skills

brycewang-stanford/Awesome-Journal-Skills/CLAUDE.md

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

1.2k3mo agoDiscuss

Chorus-AIDLCCLAUDE.md

Chorus

Chorus-AIDLC/Chorus/CLAUDE.md

Chorus is an AI Agent & Human collaboration platform implementing the AI-DLC (AI-Driven Development Lifecycle) workflow. AI Agents (with fine-grained, configurable permissions) and humans work together through a shared Idea…

1.2k5mo agoDiscuss

affaan-mCLAUDE.md

agentshield

affaan-m/agentshield/CLAUDE.md

Security auditor for AI agent configurations (Claude Code, MCP servers, hooks, agents). Grades: A (>=90), B (>=75), C (>=60), D (>=40), F (<40) Tests in tests/ mirror src/ structure. Use makeFinding(), makeSettings(), etc. helper factories. Run specific suite: npx vitest run tests/rules/mcp.test.ts

1.2k5mo agoDiscuss

sheshbabuCLAUDE.md

zen

sheshbabu/zen/CLAUDE.md

Zen is a self-hosted notes app: Go backend with SQLite (FTS5), Preact frontend bundled by esbuild. For watch mode, install: - Service boundaries, feature layout, routing, env vars, background tasks…

1.2k6d agoDiscuss

mattprusakCLAUDE.md

autoresearch-genealogy

mattprusak/autoresearch-genealogy/CLAUDE.md

Project instructions for autoresearch-genealogy. Every prompt in prompts/ follows this structure: Each numbered prompt must include an Inputs To Replace section before ## Autoresearch Configuration.

1.2k3mo agoDiscuss

fivetakuCLAUDE.md

gptaku_plugins

fivetaku/gptaku_plugins/CLAUDE.md

플러그인 코드를 수정하고 버전을 올릴 때 반드시 아래 순서를 따른다. 하나라도 빠지면 캐시 불일치로 구버전이 로드된다. 플러그인은 각자 자기 레포(서브모듈)이므로 릴리즈도 서브모듈 레포에 단다. 버전 bump 커밋을 push한 직후, 그 커밋을 가리키는 태그 + 릴리즈를 만든다. ⚠️ 신규 플러그인 첫 설치를 수동 파이프라인으로 했다면 ~/.claude/settings.json의 enabledPlugins에 "<plugin>@gptaku-plugins": true가 있는지 반드시 확인한다. /plugin install은 이 항목을 자동으로 넣지만 수동 설치(캐시+installed_plugins.json)는 건너뛰므로, 없으면 훅·스킬이 전혀 로드되지 않은 채 "설치돼 보이는" 상태가 된다 (2026-08-24 ddiring 실사례 — 훅 미발화 원인이 코드가 아니라 미enable이었음).

1.2k24d agoDiscuss

fcakyonCLAUDE.md

claude-codex-settings

fcakyon/claude-codex-settings/.claude/CLAUDE.md

Guidance for Claude Code and other AI tools. Structured around Andrej Karpathy's observations on LLM coding pitfalls: surface assumptions, don't overcomplicate, make surgical changes, verify before moving on. Do what was asked. Nothing more, nothing less. This year is 2026. Delete > Replace > Add. Before any change, answer in order: what can I delete, what can I replace, and only then, what must I add? Ask yourself: "What can I delete instead of add, and does this trace to…

1.2k23d agoDiscuss

fcakyonCLAUDE.md

claude-codex-settings

fcakyon/claude-codex-settings/CLAUDE.md

AGENTS.md and GEMINI.md are symlinks to this file for Codex CLI and Gemini CLI compatibility. Multi-tool plugin marketplace. Each plugin under plugins/ is independently installable on Claude Code, Codex CLI, Gemini CLI, and Cursor. Each plugin has 4 manifest files. Claude Code manifest is the source of truth; others are copies or subsets.

1.2k23d agoDiscuss

LING71671CLAUDE.md

open-reverselab

LING71671/open-reverselab/CLAUDE.md

参见 AGENTS.md 获取完整的 Agent 行为约定。

1.2k3mo agoDiscuss

vm0-aiCLAUDE.md

vm0

vm0-ai/vm0/CLAUDE.md

AGENTS.md links to this file. Keep shared instructions here and load detailed guidance only for the surface being changed. - API endpoints belong in turbo/apps/api (Hono, src/signals/routes/). Browser clients call…

1.2k6mo 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.