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 firstWorked for most · soon
affaan-mCLAUDE.md

ECC

affaan-m/ECC/CLAUDE.md

This is a Claude Code plugin - a collection of production-ready agents, skills, hooks, commands, rules, and MCP configurations. The project provides battle-tested workflows for software development using Claude Code. The project is organized into several core components: Follow the formats in CONTRIBUTING.md: - Agents: Markdown with frontmatter (name, description, tools, model) - Skills: Clear sections (When to Use, How It Works, Examples) - Commands: Markdown with description frontmatter - Hooks: JSON with matcher and hooks array File naming: lowercase…

246k30d agoDiscuss
affaan-mCLAUDE.md

ECC / examples

affaan-m/ECC/examples/CLAUDE.md

This is an example project-level CLAUDE.md file. Place this in your project root. [Brief description of your project - what it does, tech stack]

246k30d agoReads credentialsDiscuss
multica-aiCLAUDE.md

andrej-karpathy-skills

multica-ai/andrej-karpathy-skills/CLAUDE.md

Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed. Tradeoff: These guidelines bias toward caution over speed. For trivial tasks, use judgment. Don't assume. Don't…

214k6mo agoDiscuss
n8n-ioCLAUDE.md

n8n

n8n-io/n8n/.github/CLAUDE.md

@../AGENTS.md This folder contains n8n's GitHub Actions infrastructure. Reusable workflows: add -reusable or -callable suffix. Add workflow: Create in workflows/, document in WORKFLOWS.md. Always declare a least-privilege top-level permissions: block…

206k19d agoDiscuss
Significant-GravitasCLAUDE.md

AutoGPT / classic

Significant-Gravitas/AutoGPT/classic/CLAUDE.md

AutoGPT Classic is an experimental, unsupported project demonstrating autonomous GPT-4 operation. Dependencies will not be updated, and the codebase contains known vulnerabilities. This is preserved for educational/historical purposes. All packages…

188k18d agoReads credentialsDiscuss
firecrawlCLAUDE.md

firecrawl

firecrawl/firecrawl/CLAUDE.md

Firecrawl is a web scraper API. The directory you have access to is a monorepo: - apps/api has the actual API and worker code - apps/*-sdk are various SDKs When…

186k16mo agoReads credentialsDiscuss
fCLAUDE.md

prompts.chat

f/prompts.chat/CLAUDE.md

Quick reference for Claude Code when working on prompts.chat prompts.chat is a social platform for AI prompts built with Next.js 16 App Router, React 19, TypeScript, and PostgreSQL/Prisma. It allows…

170k8mo agoReads credentialsDiscuss
Hugging FaceCLAUDE.md

transformers

huggingface/transformers/CLAUDE.md

.ai/AGENTS.md

167k23d agoDiscuss
MicrosoftCLAUDE.md

PowerToys

microsoft/PowerToys/.claude/CLAUDE.md

../.github/copilot-instructions.md

139k8mo agoDiscuss
garrytanCLAUDE.md

gstack

garrytan/gstack/CLAUDE.md

test:evals requires ANTHROPICAPIKEY. Codex E2E tests (test/codex-e2e.test.ts, test/codex-e2e-sol-scope.test.ts) use Codex's own auth — the hermetic runner copies only auth.json from ${CODEXHOME:-~/.codex} and pins CODEXHOME in the child env — no OPENAIAPIKEY env var needed. Hermetic E2E + env keys: every E2E runner spawns children through test/helpers/hermetic-env.ts (allowlist-scrubbed env, fresh seeded CLAUDECONFIGDIR, temp GSTACKHOME, --strict-mcp-config); per-test env: overrides merge last onto a COMPLETE hermetic env, so they're safe. A PTY test that types a /skill command must pass seedSkills: true. Debug…

134k6d agoReads credentialsDiscuss
garrytanCLAUDE.md

gstack / model-overlays

garrytan/gstack/model-overlays/claude.md

Todo-list discipline. When working through a multi-step plan, mark each task complete individually as you finish it. Do not batch-complete at the end. If a task turns out to be unnecessary, mark it skipped with a one-line reason. Think before heavy actions. For complex operations (refactors, migrations, non-trivial new features), briefly state your approach before executing. This lets the user course-correct cheaply instead of mid-flight. Dedicated tools over Bash. Prefer Read, Edit, Write, Glob, Grep over shell equivalents (cat, sed,…

134k6d agoDiscuss
nextlevelbuilderCLAUDE.md

ui-ux-pro-max-skill

nextlevelbuilder/ui-ux-pro-max-skill/CLAUDE.md

UI UX Pro Max is an AI-powered design intelligence toolkit providing searchable databases of UI styles, color palettes, font pairings, chart types, and UX guidelines. It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.). Domain search: - product - Product type recommendations (SaaS, e-commerce, portfolio) - style - UI styles (glassmorphism, minimalism, brutalism) + AI prompts and CSS keywords - typography - Font pairings with Google Fonts imports - color - Color palettes by product…

131k3d agoDiscuss
nextlevelbuilderCLAUDE.md

ui-ux-pro-max-skill / stack

nextlevelbuilder/ui-ux-pro-max-skill/stack/CLAUDE.md

This repository is a ready-to-use environment that makes Claude Code good at website design. When you (Claude) do any UI, web page, landing page, component, or visual-polish work in a project that uses this stack, follow the workflow below. It combines a knowledge layer (what to build), a taste layer (making it distinctive), and a feedback layer (actually seeing the rendered result and fixing it). 1. PLAN with data — ui-ux-pro-max. Before writing markup, get a concrete design system. Run…

131k3d agoDiscuss
browser-useCLAUDE.md

browser-use

browser-use/browser-use/CLAUDE.md

Browser-Use is an async python >= 3.11 library that implements AI browser driver abilities using LLMs + CDP (Chrome DevTools Protocol). The core architecture enables AI agents to autonomously navigate web pages, interact with elements, and complete complex tasks by processing HTML and making LLM-driven decisions. The library follows an event-driven architecture with several key components: BrowserSession uses a bubus event bus to coordinate watchdog services: - DownloadsWatchdog: Handles PDF auto-download and file management - PopupsWatchdog: Manages JavaScript dialogs and…

117k4mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman / browse

JuliusBrussee/caveman/browse/CLAUDE.md

Repository routing: do not continue Browse product work here. Source of truth is JuliusBrussee/caveman-browse, local checkout /Users/julb/Desktop/GitHub/caveman-browse. This directory is a consumer copy; edit only for pinned integration, migration/removal, or…

108k6mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman

JuliusBrussee/caveman/CLAUDE.md

README = product front door. Non-technical people read it to decide if caveman worth install. Treat like UI copy. Rules for any README change: Caveman makes AI coding agents respond…

108k6mo agoPipes a download into a shellDiscuss
JuliusBrusseeCLAUDE.md

caveman / engine

JuliusBrussee/caveman/engine/CLAUDE.md

Detect a payload's type → route to a safety-classed compressor → count the token reduction → store the original for recovery. The stable four-call API (Compress/Retrieve/Detect/Stats) is what the proxy,…

108k6mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman / extension

JuliusBrussee/caveman/extension/CLAUDE.md

The consumer top-of-funnel: a toggle that, on ChatGPT / Claude / Gemini, prepends the caveman skill directive to each message you send and re-fires the send, so the AI replies…

108k6mo agoDiscuss

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.