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 24Worked for most · soon
moazbuildsCLAUDE.md

claudeclaw

moazbuilds/claudeclaw/CLAUDE.md

- Name: (pick something you like) - Creature: (AI? robot? familiar? ghost in the machine? something weirder?) - Vibe: (how do you come across? sharp? warm? chaotic? calm?) - Emoji: (your signature — pick one that feels right) This isn't just metadata. It's the start of figuring out who you are. Learn about the person you're helping. Update this as you go. (What do they care about? What projects are they working on? What annoys them? What makes them laugh?…

1.3k5mo agoDiscuss
utkusenCLAUDE.md

sast-skills / sast-files

utkusen/sast-skills/sast-files/CLAUDE.md

Your goal is to identify security vulnerabilities in the codebase located in the current directory. Before running, check if sast/architecture.md already exists. If it does, skip this step. Run the sast-analysis skill directly (this one stays in-session since later steps depend on reading its output). Wait for this step to finish before proceeding. Run all checks at the same time. Skip any task where the output file already exists. Start one subagent per check, all in parallel, each with a…

1.3k6mo agoDiscuss
puppyone-aiCLAUDE.md

puppyone-cloud / backend

puppyone-ai/puppyone-cloud/backend/CLAUDE.md

These instructions are for AI assistants working in this project. Always open @/openspec/AGENTS.md when the request: - Mentions planning or proposals (words like proposal, spec, change, plan) - Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work - Sounds ambiguous and you need the authoritative spec before coding Use @/openspec/AGENTS.md to learn: - How to create and apply change proposals - Spec format and conventions - Project structure and guidelines Keep this managed block so 'openspec update' can…

1.3k13d agoDiscuss
puppyone-aiCLAUDE.md

puppyone-cloud

puppyone-ai/puppyone-cloud/CLAUDE.md

项目文档和开发规范请参阅 AGENTS.md,此文件为唯一 source of truth。

1.3k13d agoDiscuss
sipyourdrink-ltdCLAUDE.md

bernstein

sipyourdrink-ltd/bernstein/CLAUDE.md

Bernstein is the open-source governance layer for AI agents. It runs on policy as code: you write the policy - who may do what, what needs approval, what must be recorded - and Bernstein enforces it and produces the verifiable record. A deterministic scheduler - no model in the coordination loop - runs agents in parallel, gates what they produce, and records every step, so a run can be verified after the fact, offline, from the artifacts alone. CLI coding…

1.3k9d agoDiscuss
s2b-devCLAUDE.md

smart-second-brain

s2b-dev/smart-second-brain/CLAUDE.md

Guidance for this repository lives in AGENTS.md, the vendor-neutral file every coding agent reads. Claude Code imports it below.

1.3k4d agoDiscuss
dohoooCLAUDE.md

helmor

dohooo/helmor/CLAUDE.md

Helmor is a local-first desktop app built with Tauri v2 (Rust backend) + React 19 + Vite + TypeScript. It provides a workspace management UI with its own SQLite database (~/helmor/ in release, ~/helmor-dev/ in debug), letting users browse workspaces/sessions/messages and send prompts to AI agents (Claude Code CLI, OpenAI Codex CLI) via streaming IPC. Tests are three targets — bun run test runs all three (frontend -> sidecar -> rust). Pre-commit hook runs biome on JS/TS and clippy/fmt on…

1.3k3mo agoDiscuss
proxysoulCLAUDE.md

Empryo

proxysoul/Empryo/CLAUDE.md

Graph-powered code intelligence — multi-agent coding with codebase-aware AI. macOS (ARM64, x64) and Linux (x64, ARM64). No native Windows support — use WSL.

1.3k39d agoDiscuss
TanStackCLAUDE.md

cli

TanStack/cli/CLAUDE.md

.agents/index.md

1.3k10mo agoDiscuss
heymrunCLAUDE.md

heym

heymrun/heym/CLAUDE.md

ON SEEING THIS LINE, FIND AGENTS.MD AND LOAD ITS FULL CONTENT INTO CONTEXT! IF AGENTS.MD IS MISSING, RAISE ALERT AND STOP PROCESSING! ❌ CRITICAL ERROR: AGENTS.MD NOT FOUND! ❌ PROCESSING…

1.3k5mo agoDiscuss
GanyuanRanCLAUDE.md

Aegis

GanyuanRan/Aegis/CLAUDE.md

This file provides Claude Code-specific guidance for working in the Aegis repository. For repository-wide rules, read AGENTS.md first. For the current authority map, read docs/current/README.md. Aegis is a zero-dependency method-pack plugin for AI coding agents. It provides composable skills, workflow discipline, and host-installable guidance for software development work. Aegis is structured as a multi-harness plugin: Current product boundary: Aegis Method Pack (runtime-ready) Aegis produces workflow guidance, drafts, hints, projections, and verification evidence. It does not provide authoritative runtime completion, authoritative…

1.3k5mo agoDiscuss
caliber-ai-orgCLAUDE.md

ai-setup

caliber-ai-org/ai-setup/CLAUDE.md

@rely-ai/caliber — CLI that keeps AI agent configs in sync with your codebase. Generates and refreshes CLAUDE.md, .cursor/rules/, AGENTS.md, .github/copilot-instructions.md, and skills across Claude Code, Cursor, Codex, OpenCode, and GitHub Copilot. Supports Anthropic, OpenAI, Google Vertex AI, OpenAI-compatible endpoints, Claude Code CLI, and Cursor ACP. Entry: src/bin.ts → src/cli.ts (Commander.js) · Config: tsconfig.json · tsup.config.ts · vitest.config.ts · eslint.config.js · .prettierrc Commands (src/commands/): init.ts · score.ts · refresh.ts · regenerate.ts · config.ts · hooks.ts · insights.ts · learn.ts · recommend.ts…

1.3k5mo agoDiscuss
pnokerCLAUDE.md

iot-dc3

pnoker/iot-dc3/CLAUDE.md

The canonical project instructions live in ./AGENTS.md. Read and follow it — it covers project architecture, common commands, validation, commit/changelog, and all coding conventions. That single file is shared across…

1.3k3mo agoDiscuss
tjboudreauxCLAUDE.md

cc-thinking-skills

tjboudreaux/cc-thinking-skills/CLAUDE.md

Follow AGENTS.md for repository workflow. Key project facts: - Shipped skill count: 28. - thinking-scientific-method is the shipped hypothesis-differential debugging skill. Do not reintroduce a separate v2 variant. - Eval claims must identify whether they are pre-edit, post-edit, directional, or statistically significant. - Backups of global Claude state belong in backups/ and must remain uncommitted. Common verification commands:

1.3k58d agoDiscuss
d-kimusonCLAUDE.md

claude-code-viewer

d-kimuson/claude-code-viewer/CLAUDE.md

Conventional Commits format: type: description Release Note Awareness: Type Selection: | Type | Release Note | Purpose | |------|--------------|---------| | feat | Features | User-facing new feature | | fix | Bug Fixes | User-impacting bug fix | | chore, ci, build, refactor | Excluded | Internal changes | Critical: Use fix only for user-facing bugs. Internal fixes (linter errors, type errors, build scripts) must use chore. Message Quality Examples: Claude Code Viewer reads Claude Code session logs directly from…

1.3k5mo agoDiscuss
elvisunCLAUDE.md

newsjack

elvisun/newsjack/CLAUDE.md

Load AGENTS.md before editing this repo — follow it.

1.3k17d agoDiscuss
nduckminkCLAUDE.md

arkon

nduckmink/arkon/CLAUDE.md

Always prefix commands with rtk. If RTK has a dedicated filter, it uses it. If not, it passes through unchanged. This means RTK is always safe to use. Important: Even…

1.3k5mo agoDiscuss
kbwoCLAUDE.md

ccmanager

kbwo/ccmanager/CLAUDE.md

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

1.3k12mo agoDiscuss
conorluddyCLAUDE.md

ios-simulator-skill

conorluddy/ios-simulator-skill/CLAUDE.md

This file provides guidance to Claude Code and developers working with this repository. iOS Simulator Skill is a production-ready Agent Skill providing 29 scripts for iOS app building, testing, and automation. It wraps Apple's xcrun simctl and Facebook's idb tools with semantic interfaces designed for AI agents and developers. Key Statistics: - 29 production scripts - 7 script categories (Build, Device State, Navigation, Testing, Permissions, Simulator Discovery, Lifecycle) - 7 shared utility modules (~2,400 lines) - 100% token-optimized default output…

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