Awesome Claude.md

A curated collection of high-quality CLAUDE.md files from leading open-source projects. These examples demonstrate industry best practices for onboarding AI assistants to complex codebases.

🚀 Quick Start: New here? Jump to Top Picks or browse by Technology | Use Case

🎯 Quick Filters

📋 Table of Contents

🎯 Top Picks - Start here for the best examples
🔍 Browse by Technology - Find examples by tech stack
🎨 Browse by Use Case - Find examples by purpose
📂 All Categories - Complete categorized list
🔧 Tools & Ecosystem - Tools for CLAUDE.md workflows
🏆 Quality Standards - Our selection criteria
🤝 Contributing - How to add examples
🔎 Search GitHub - Find more examples

🧭 Navigation Tips

New to the repository? Here's how to find what you need quickly:

🎯 Start with Top Picks - Hand-curated best examples
🔍 Use Quick Filters above to jump to specific categories
📊 Check badges for repository activity and popularity:
- Repository popularity
- Legal information
- Recent activity
📂 Browse All Categories for comprehensive lists
💡 Use browser search (Ctrl+F / Cmd+F) to find specific technologies or patterns

Pro Tips:

Click category headers to expand/collapse sections
Links marked with bold text are our top recommendations within each category
Each example includes analysis explaining what makes it exemplary

🎯 Top Picks

Start with these exceptional examples - hand-picked for learning effective CLAUDE.md patterns:

🥇 Essential (Must Read)

Example	Why It's Great	Tech Stack
OpenAI Agents Python	Official OpenAI multi-agent framework	Python, Multi-Agent Systems
Basic Memory	Cutting-edge MCP integration & AI collaboration	Python, FastAPI, SQLAlchemy
Overreacted.io	Technical depth with personality	Next.js, React, MDX
Pydantic GenAI Prices	Expert data processing pipeline patterns	Python, Pydantic, YAML

🥈 Advanced Patterns

Example	Why It's Great	Tech Stack
Citadel Protocol Contracts	Security-first DeFi protocol architecture	Solidity, TypeScript, DeFi
OpenFeign QueryDSL	Enterprise Java framework excellence	Java, Multi-Backend Query
Callstack React Native Testing	Testing library gold standard	TypeScript, React Native
H1B Visa Analysis	AI-guided development framework	TypeScript, Meta-Repository
Claude Flow	Enterprise AI orchestration platform	JavaScript, 64-Agent System
Cloudflare Workers SDK	Monorepo & testing excellence	TypeScript, Monorepo
Anthropic Quickstarts	Multi-project organization by AI experts	Python, TypeScript, React
GoMall	RIPER-5 AI methodology	Go, AI Development

🔍 Browse by Technology

🟦 TypeScript/JavaScript (38 examples)

Callstack React Native Testing - Testing library gold standard from React Native experts
Citadel Protocol Contracts - Security-first DeFi protocol documentation
Clueless - AI meeting assistant with Vue 3 + Laravel real-time architecture
Foam - Personal knowledge management for VSCode
H1B Visa Analysis - AI-guided meta-repository framework
SDLC Engine - State machine workflow orchestration
WhereAmI - SvelteKit with Svelte 5
Cloudflare Workers SDK - Monorepo patterns
Claude Crew - Strict TypeScript standards
Web Builder - B2B2B SaaS platform with Next.js 14
Lula 2 - Git-friendly compliance control management
MCP WordPress - MCP server for WordPress CMS
mdx-prompt - LLM prompt components
GalaChain SDK - Blockchain SDK with TypeScript
Overreacted.io - Next.js with MDX
noren - Edge-native PII redaction library
Image Generation MCP - MCP server with Cloudflare Workers
Pixel Banner - Obsidian plugin with customizable banners
KleverConnect Starter - Web3 React + Vite
Kubb - OpenAPI TypeScript generator
Lerna - Monorepo management tool
MeFood Next.js - Modern Next.js food application
Agentic - AI agent orchestration library
Semantic Workbench - Microsoft AI assistant platform
Neon MCP Server - Production MCP server for Neon database
Nine Week Challenge - Next.js 14 App Router wellness app
Webhook Broker - Event-driven microservice architecture
Omar Dulaimi Prisma tRPC Generator - Modern full-stack TypeScript tooling integration
SYMBIONT - First browser extension example with AI integration
Platformatic - Node.js application platform
Claude Flow - Enterprise AI orchestration platform
claude-code-mastra - AI SDK adapter patterns for framework integration
PMStander Web Tools - Advanced performance optimization patterns
Yutodo - Full-stack application documentation
CKBoost - CKB blockchain gamified engagement platform
SmartQ - AI-powered educational question analysis platform
VeilChat - Full-stack chat with PWA and MCP integration
pkg-to-jsr - Zero-config JSR generator from package.json

🟧 Python (25 examples)

Anthropic Quickstarts - Computer-use demo
Basic Memory - MCP integration
BEDROT Data Ecosystem - Music industry analytics data pipeline
Composio - AI agent integration platform
DataFog Python - Privacy-focused data processing
Swift Law - Legal AI assistant
GenSX - AI-powered scientific computing
HADES - Information processing network architecture
Ultimate RVC - AI-powered audio content creation
HA Irrigation Strategy - Smart home agriculture automation
FastAPI Template - Enterprise-grade Python backend with three-layer architecture
Jason Liu Blog - AI/ML thought leadership
HendrixVideo - AI-powered video analysis pipeline
SummaryBot NG - Agent-based development framework
LangChain Redis - Redis integration for LangChain
Web Monitoring - Enterprise monitoring system
Context Creator - AI-optimized codebase analysis
Web MuJoCo Gym - High-performance WebAssembly
OpenAI Agents Python - Official multi-agent framework
Pydantic GenAI Prices - Expert data processing pipeline
PyTorch tlparse - Dual-language (Rust/Python)
Demo MCP - MCP server architecture patterns
Stata-MCP - MCP server for Stata statistical analysis
viral-assemble - Viral genome assembly toolkit from Broad Institute
Weaviate Docs - Documentation for Weaviate Database

🟫 Rust (10 examples)

Breenix OS - Rust kernel development with rigorous engineering standards
cctx - Claude Code context manager with UX philosophy documentation
Cribo - Python source bundler with exhaustive AI agent directives
Workerd - JavaScript runtime for Cloudflare Workers
msg-rs - Distributed systems messaging library
OAuth2 Passkey - Modern authentication library
Claude Code F2 - Systematic development framework
PyTorch tlparse - Log parsing with Python bindings
SVGC - SVG optimization tool
Tasker Core - Workflow orchestration engine

🔶 Java (1 example)

OpenFeign QueryDSL - Enterprise multi-backend query framework

🟢 Go (5 examples)

Claudio - Audio feedback plugin with TDD methodology
Dymension Hub - Cosmos SDK settlement layer with modular rollup architecture
GoMall - RIPER-5 AI methodology
ReGo - Unified REST API abstraction layer for enterprise services
Sentry - Multi-language error tracking platform

🔵 Swift (4 examples)

CartWise - iOS shopping app with MVVM+Coordinator and Swift Actor model
macMCP - macOS MCP server implementation
Xcode Project CLI - Xcode project manipulation tool
TrysteroSwift - P2P WebRTC data channels

🟨 Other Languages (14 examples)

C++

ada - WHATWG-compliant URL parser library

Elixir

mehr-schulferien.de - Phoenix web application with rigorous test quality standards
trifle_stats - First Elixir example - Multi-database time-series library

Kotlin

Kotlinter Gradle - Kotlin linting plugin

Lua

claudecode.nvim - Claude Code Neovim IDE Extension
CodeCompanion.nvim - LLM-powered Neovim coding assistant

Node.js (C++)

HWP - Node.js HTTP benchmarking

Smalltalk

B+ Tree - Smalltalk data structure implementation

Haskell

Pipewire-HS - Haskell bindings for PipeWire

Python (Type Generation)

mypy-boto3-builder - AWS SDK type stubs generator

PHP/Vue.js

WindPress - Vue.js with WebAssembly Tailwind compilation

C#/.NET

TimeWarp Architecture - C#/.NET Blazor WebAssembly framework

Markdown/Documentation

Tasker Systems Book - Narrative-driven technical documentation

Svelte

Microfolio - Static portfolio generator with SvelteKit 2

🎨 Browse by Use Case

🤖 Advanced AI Development (13 examples)

OpenAI Agents Python - Official multi-agent framework
Basic Memory - MCP integration patterns
Claude Flow - Enterprise AI orchestration
Anthropic Quickstarts - Computer-use demo
Composio - AI agent integration platform
Agentic - AI agent orchestration library
Stata-MCP - MCP server for Stata statistical analysis
GoMall - RIPER-5 AI methodology
Jason Liu Blog - AI/ML thought leadership
Ultimate RVC - AI-powered audio creation
Swift Law - Legal AI assistant
Context Creator - AI-optimized codebase analysis
Semantic Workbench - Microsoft AI assistant platform

🏗️ Infrastructure Projects (8 examples)

Breenix OS - Rust kernel development with rigorous engineering
Cloudflare Workerd - JavaScript runtime for Cloudflare Workers
Lula 2 - Git-friendly compliance control management
Dymension Hub - Cosmos SDK settlement layer for modular rollups
TrailOfBits Algo - Security-first VPN server setup
Ansible MCP Server - Infrastructure automation with MCP
Sentry - Multi-language error tracking platform
Webhook Broker - Event-driven microservice architecture

🌐 Web3 & Blockchain (4 examples)

Citadel Protocol Contracts - Security-first DeFi protocol with multi-stakeholder architecture
GalaChain SDK - Blockchain SDK for chaincode development
KleverConnect Starter - Web3 React + Vite starter kit
Ethereum.org Website - Official Ethereum community website

🧪 Testing & Quality (1 example)

Callstack React Native Testing - Professional testing library with three-tier query system

⚡ High Performance Computing (4 examples)

ada - WHATWG-compliant C++ URL parser
Web MuJoCo Gym - WebAssembly ML/RL environment
TimeWarp Architecture - Blazor WebAssembly framework
Pipewire-HS - Haskell bindings for PipeWire

🚀 Getting Started (6 examples)

Anthropic Quickstarts - Official Anthropic quickstart examples
Ethereum.org Website - Official Ethereum community website
KleverConnect Starter - Web3 React + Vite starter kit
Microfolio - Static portfolio generator with SvelteKit 2
Dotfiles - Personal development environment configuration
Weaviate Docs - Documentation for Weaviate Database

📂 All Categories

🏢 Complex Projects

Multi-service applications with sophisticated architectures and enterprise-scale concerns.

Citadel Protocol Contracts - Security-first DeFi protocol architecture
- Multi-stakeholder documentation (Minters vs Liquidity Providers)
- Protocol economics and synthetic stablecoin mechanics
- Comprehensive security considerations and deployment strategies
H1B Visa Analysis - AI-guided meta-repository framework
- 17-module meta-repository architecture
- Progressive context loading for AI assistants
- XML-structured prompt engineering system
WhereAmI - SvelteKit location-based social application
- SvelteKit with Svelte 5 architecture
- Real-time geolocation and social features
- Modern full-stack development patterns
TimeWarp Architecture - Blazor WebAssembly clean architecture framework
- CQRS with MediatR patterns
- Blazor WebAssembly for high-performance web applications
- Clean architecture principles
Basic Memory - Cutting-edge MCP integration & AI collaboration
- MCP-first architecture patterns
- AI-native development workflows
- Advanced memory management for AI systems
Web Builder - B2B2B SaaS platform with Next.js 14
- Multi-tenant architecture with agency sub-accounts
- Drag & drop website/funnel builder
- Stripe Connect integration for multi-vendor payments
action-idle - TypeScript idle game with ESLint-enforced Godot portability constraint
- Architectural boundary (/src/core/ pure TypeScript) enforced via ESLint rule, not just documentation
- TypeScript↔GDScript translation table mapping idioms to their Godot equivalents
- 11 named design principles with ✅/❌ code comparisons and entity-to-signal architecture mapping
Overreacted.io - Dan Abramov's technical blog with exceptional documentation
- Technical depth with personality
- Complete development workflow
- Advanced MDX features and static site generation
Claude Flow - Enterprise AI orchestration platform
- 64-agent system with sophisticated coordination patterns
- Modular AI platform architecture with comprehensive testing
- Production-ready deployment with advanced workflow management
HADES - Information processing network architecture
- Mathematical conveyance framework with hybrid database architecture
- PostgreSQL and ArangoDB integration with MCP server patterns
- Context amplification and late chunking embedding strategies
HADES (Defunct) - Research-grade academic paper processing system
- Mathematical framework integration with GPU-accelerated processing
- Complex multi-component architecture with theoretical foundations
- Advanced context management for AI systems (note: project marked as defunct)
HendrixVideo - AI-powered video analysis pipeline
- Multi-modal AI pipeline architecture with video, audio, and text processing
- Configuration-driven architecture with multiple processing profiles
- Advanced resource management for AI-intensive applications
Sentry - Multi-language error tracking and performance monitoring
- Cross-platform error tracking system
- Real-time monitoring and alerting
- Comprehensive debugging and performance insights
Web Monitoring - Enterprise Flask/Vue.js monitoring system
- Full-stack monitoring architecture
- Real-time performance tracking
- Comprehensive dashboard and alerting system
Semantic Workbench - Microsoft AI assistant platform
- Enterprise-scale AI assistant development platform
- Multi-modal AI interaction patterns
- Professional deployment and scaling strategies
Nine Week Challenge - Next.js 14 wellness tracking application
- App Router with server components
- Real-time progress tracking
- Modern React patterns with TypeScript
Webhook Broker - Event-driven microservice architecture
- Scalable webhook processing system
- Event-driven architecture
- Message queuing patterns
OpenAI Agents Python - Official OpenAI multi-agent framework
- Official OpenAI documentation patterns
- Multi-agent architecture and coordination
- Enterprise-grade AI system design
Platformatic - Node.js application platform
- Full-stack Node.js development platform
- Database-to-API automation
- Plugin-based architecture
WindPress - Vue.js with WebAssembly Tailwind compilation
- In-browser CSS compilation using WebAssembly
- WordPress plugin development patterns
- Modern Vue.js Composition API with TypeScript
SmartQ - AI-powered educational question analysis platform
- Adaptive education level system with Bloom's Taxonomy integration
- Dual authentication (teacher OAuth + student anonymous access)
- Real-time classroom coordination with Firebase
CartWise - Comprehensive iOS shopping application with MVVM+Coordinator architecture
- Swift Actor model for thread-safe Core Data operations
- Soft-delete implementation preserving historical data
- Reputation-based gamification system with social features
Clueless - AI meeting assistant with real-time transcription and analysis
- Direct frontend WebSocket to OpenAI Realtime API via ephemeral keys
- Dual SQLite database management for NativePHP/Electron desktop app
- Comprehensive service architecture with Vue 3 + Laravel 12
mehr-schulferien.de - German school vacation Phoenix/Elixir application
- Automated code quality enforcement via Claude Code hooks
- Rigorous test quality standards with measurable criteria
- Feature maintenance mode documentation with re-enablement steps
BEDROT Data Ecosystem - Music industry analytics data pipeline ecosystem
- Multi-zone ETL architecture with six data processing stages
- Semi-manual authentication design philosophy for 2FA compliance
- Service-specific cookie lifecycle management and error severity classification

🛠️ Developer Tooling

CLI tools, build systems, and development utilities with focus on commands and configuration.

Claudio - Hook-based audio feedback plugin for Claude Code
- Strict TDD methodology with Red-Green-Refactor discipline
- 5-level sound fallback system with graceful degradation
- Cross-platform audio via malgo with XDG-compliant configuration
claudecode.nvim - Claude Code Neovim IDE Extension
- WebSocket server with MCP protocol implementation
- Zero-dependency architecture using Neovim built-ins
- 320+ tests covering all MCP tools
MCP WordPress - MCP server for WordPress CMS integration
- Model Context Protocol server development
- Multi-site WordPress management patterns
- Security-first architecture with data sanitization
OpenFeign QueryDSL - Enterprise Java multi-backend query framework
- Advanced Maven profiles and build system documentation
- Code generation patterns with Q-classes and annotation processing
- Sophisticated testing strategies across multiple database backends
SDLC Engine - State machine workflow orchestration
- Comprehensive workflow automation
- State machine patterns for software development
- Testing-driven development methodology
Stata-MCP - MCP server for Stata statistical analysis and LLM integration
- Security Guard pattern with command blacklisting for safe code execution
- RAM Monitor pattern with automatic process termination
- Hierarchical configuration system (env vars > config file > defaults)
HA Irrigation Strategy - Advanced smart home agriculture automation
- Four-Phase automation cycle with statistical analysis
- Home Assistant integration with real-time sensor processing
- Advanced IoT system architecture patterns
Cloudflare Workers SDK - Monorepo management and edge computing development
- Comprehensive monorepo patterns
- Edge computing development workflows
- Testing and deployment strategies
CodeCompanion.nvim - LLM-powered Neovim coding assistant
- Four distinct interaction modes (Chat, Inline, Cmd, Workflow)
- Multi-provider adapter system with HTTP and ACP adapters
- Lua development standards with function parameter patterns
Cribo - Python source bundler written in Rust
- Function-level code navigation guide with exact file paths
- Critical decision point documentation for wrapper-vs-inline classification
- Strict AI agent behavioral directives with deterministic output requirements
Lula 2 - Git-friendly compliance control management system
- Individual YAML files per security control for meaningful Git diffs
- SvelteKit 5 Runes state management with CLI-embedded Express server
- OSCAL framework integration for NIST 800-53 compliance
Kargo - Knowledge graphs and information retrieval
- Graph-based data management
- Information retrieval and processing
- AI-powered knowledge organization
Claude Crew - Strict TypeScript development standards
- Code quality enforcement
- TypeScript best practices
- Development workflow optimization
Swift Law - Domain-specific legal AI assistant
- Context-bounded RAG architecture for legal documents
- Professional AI deployment patterns
- Domain-specific validation techniques
Foam - Personal knowledge management for VSCode
- Platform-agnostic core with event-driven architecture
- Planning-first development workflow methodology
- Sophisticated testing architecture with test category distinction
Kotlinter Gradle - Kotlin linting and formatting plugin
- Gradle plugin development patterns
- Code quality automation
- Kotlin development best practices
Image Generation MCP - MCP server for AI image generation
- MCP protocol implementation
- Cloudflare Workers deployment
- AI service integration patterns
repo-reconnoiter-rails - Rails 8.1 OSINT dashboard with cost-first AI integration philosophy
- "Cost Control" as the first core principle with $10/month target enforced via a single cost-tracking service
- "Doer" naming convention documented with ✅/❌ strikethrough examples for service objects
- AI prompts as versioned ERB templates in app/prompts/ — prompt-as-code pattern in a Rails context
Pixel Banner - Obsidian plugin with customizable banner images
- Task-oriented plugin documentation
- Multi-layered testing strategy
- Complete architectural flow mapping
Jason Liu Blog - AI/ML thought leadership and technical blogging
- Technical content creation workflows
- AI/ML best practices and insights
- Professional development documentation
Kubb - OpenAPI TypeScript generator
- Code generation from OpenAPI specifications
- TypeScript tooling development
- API client generation patterns
Lerna - Monorepo management tool
- Multi-package repository management
- Version management and publishing
- JavaScript ecosystem tooling
GoMall - RIPER-5 AI methodology for Go development
- AI-driven development methodology
- Go microservices architecture
- E-commerce platform patterns
Context Creator - AI-optimized codebase analysis tool
- Automated codebase analysis for AI assistants
- Context generation and optimization
- Development workflow enhancement
HWP - HTTP benchmarking and performance testing
- Performance testing methodologies
- HTTP benchmarking tools
- Node.js performance optimization
cctx - Claude Code context manager for switching between settings
- UX philosophy documentation: predictability over cleverness
- File-based context architecture with transparent state management
- Dedicated "Notes for AI Assistants" section with testing checklists
Neon MCP Server - Production-grade MCP server for Neon database API
- Dual-purpose architecture (remote server + local CLI)
- Stateless serverless design patterns
- Comprehensive tool development guide
macMCP - macOS MCP server implementation
- Platform-specific MCP integration with macOS accessibility APIs
- Swift system programming patterns
- Real-world testing philosophy with end-to-end validation
SVGC - SVG optimization and compression tool
- Graphics optimization algorithms
- Command-line tool development
- Performance-focused design
OpenShift ROSA - Enterprise Kubernetes CLI tool with ethical AI integration
- Clear role boundaries and professional development standards
- Comprehensive testing framework with Ginkgo/Gomega patterns
- Enterprise-grade Go development with community guidelines
SYMBIONT - AI-powered Chrome extension architecture (First browser extension example)
- Message-driven architecture with MessageBus for inter-component communication
- Security-first design with GDPR compliance and client-side encryption
- Dual-stack architecture (TypeScript + React frontend, Express + PostgreSQL backend)
Claude Code F2 - Systematic development framework
- 6-phase development workflow methodology
- Testing-driven development with comprehensive validation
- Rust-based development tools and frameworks
PyTorch tlparse - Log parsing and analysis tool
- Dual-language (Rust/Python) architecture
- Performance-critical log processing
- ML/AI debugging and optimization
claude-code-mastra - Claude Code SDK integration for Mastra framework
- Clean adapter patterns for AI SDK interoperability
- Session lifecycle management with automatic cleanup
- Tool conflict resolution and unified interface patterns
Tasker Core - Rust workflow orchestration engine
- Advanced workflow orchestration patterns
- Testing-driven development methodology
- High-performance task processing
mypy-boto3-builder - AWS SDK type stubs generator
- Type stub generation for Python
- AWS integration patterns
- Developer tooling for cloud services
SummaryBot NG - Agent-based development framework
- SPARC methodology for structured AI-assisted development
- Performance-optimized AI workflows with measurable improvements
- Advanced concurrent execution patterns with AI assistant coordination
Xcode Project CLI - Xcode project manipulation tool
- Swift-based CLI architecture with comprehensive command documentation
- Domain-specific tool development for Xcode project file manipulation
- Clear development philosophy with proactive error prevention patterns
Yutodo - Full-stack TypeScript application
- Comprehensive testing infrastructure with 6 testing methodologies
- Full-stack development patterns
- Modern TypeScript development practices
VeilChat - Full-stack chat with PWA and MCP integration
- Multi-system architecture with Azure TTS and fallback strategies
- PWA implementation with service worker caching patterns
- Comprehensive troubleshooting-first documentation
pkg-to-jsr - Zero-config JSR generator from package.json
- AI-optimized code navigation patterns
- zod-mini validation with tree-shakable architecture
- Semantic indexing guidance for efficient development

🚀 Getting Started

Projects focused on developer onboarding and initial setup experiences.

Anthropic Quickstarts - Official Anthropic quickstart examples
- Multi-project organization (Python, TypeScript, React) by AI experts
- Docker containerization with production patterns
- Technology-specific coding standards and best practices
Ethereum.org Website - Official Ethereum community website (5,000+ stars)
- Community-driven development
- Multi-language support
- Documentation workflows
KleverConnect Starter - Web3 React + Vite starter kit
- Klever Wallet integration patterns
- Custom hook design for Web3
- TypeScript-first blockchain development
Microfolio - Static portfolio generator with SvelteKit 2
- File-based content management system with Markdown and YAML frontmatter
- Multi-view architecture (gallery, datatable, interactive map)
- Environment-aware build configuration for GitHub Pages and custom domains
Dotfiles - Personal development environment configuration
- Comprehensive collaboration guidelines for AI assistant integration
- Personal dotfiles with extensive tool configuration patterns
- Detailed working parameters and communication preferences
Weaviate Docs - Documentation for Weaviate Database
- Multi-language testing patterns (Python, Java, Go)
- Dynamic version management with automated GitHub release fetching
- Docker-centric testing environments

🏗️ Infrastructure Projects

Large-scale systems, runtime environments, and platform-agnostic deployment patterns.

Breenix OS - Rust operating system kernel development
- Bare metal Rust compilation with QEMU integration
- Model Context Protocol for kernel interaction
- Rigorous engineering standards with comprehensive logging
Cloudflare Workerd - JavaScript runtime for Cloudflare Workers
- High-performance JavaScript runtime built in Rust
- Edge computing platform architecture
- V8 engine integration patterns
Dymension Hub - Cosmos SDK settlement layer for modular rollups
- Critical blockchain constraints documentation (determinism, no panics in consensus)
- Deep module architecture with inter-module dependency graph
- Exhaustive CLI user guide covering all blockchain operations
TrailOfBits Algo - Security-first VPN server setup and automation
- Comprehensive security documentation and hardening guidelines
- Multi-cloud deployment with detailed troubleshooting workflows
- Production-ready operations with performance optimization strategies
Ansible MCP Server - Infrastructure automation with MCP integration
- Ansible automation with MCP protocol
- Infrastructure as code patterns
- DevOps workflow automation
Demo MCP - MCP server architecture for system monitoring
- Cross-platform system monitoring patterns
- Async-first design with Pydantic validation
- Real-time log analysis and process management

📚 Libraries & Frameworks

Core concepts, APIs, usage patterns, and publication-ready development standards.

ada - WHATWG-compliant C++ URL parser library
- Development Checks concept distinguishing debug assertions from release builds
- CMake development workflow with comprehensive option documentation
- Benchmark methodology with explicit performance measurement guidance
Callstack React Native Testing - Professional React Native testing library
- Three-tier query system design pattern (get*/query*/find*)
- Behavioral testing philosophy from industry experts
- Comprehensive testing practices for React Native applications
GalaChain SDK - Blockchain SDK for TypeScript development
- Chaincode development patterns with TypeScript
- Multi-level testing strategy (unit, integration, e2e)
- Modular SDK architecture for blockchain applications
Composio - AI agent integration platform
- Multi-tool AI agent ecosystem
- Integration framework for AI assistants
- Comprehensive API and tooling support
CKBoost - CKB blockchain gamified engagement platform
- Task Master AI integration with PRD-First development mandate
- Blockchain-specific patterns (SSRI, ConnectedTypeID for O(1) lookups)
- Multi-Claude workflow orchestration with custom slash commands
PMStander Web Tools - Advanced TypeScript/Next.js performance patterns
- Multi-tier caching strategy (memory, Redis, CDN)
- Type-safe file processing with security validation
- Server Components with dynamic imports optimization
DataFog Python - Privacy-focused data processing library
- Privacy-preserving data processing
- Data anonymization and protection
- GDPR compliance patterns
mdx-prompt - LLM prompt engineering components
- MDX-based prompt engineering
- Component-driven prompt design
- React integration for AI applications
GenSX - AI-powered scientific computing framework
- Scientific computing with AI integration
- Research and development patterns
- Data analysis and visualization
brix-lang - New data-oriented language with full LLVM 18 compiler pipeline in Rust
- Complete compilation pipeline documented: Lexer (logos) → Parser (chumsky) → AST → Codegen (inkwell/LLVM 18) → native binary
- Quantified test baseline: 1,194 unit + 152 integration + 390 Test Library tests pinned post-Phase 4
- Step-by-step "Adding Features" guide with exact file paths and function names (compile_binary_op())
noren - Edge-native PII redaction library
- WHATWG Streams API for efficient stream processing
- Plugin architecture for country-specific PII detection
- MCP (Model Context Protocol) integration ready
Ultimate RVC - AI-powered audio content creation
- Exceptional testing methodology with 6 distinct testing approaches
- Real-time voice conversion and audio processing
- Advanced AI model integration patterns
FastAPI Template - Enterprise-grade Python backend architecture
- Three-layer architecture (API → Service → Repository → Model)
- Comprehensive RBAC and JWT authentication with security audit logging
- Complete feature development lifecycle from model to testing
Pipewire-HS - Haskell bindings for PipeWire audio system
- Functional programming patterns for audio systems
- C library integration in Haskell
- Real-time audio processing
OAuth2 Passkey - Modern authentication library
- Layered library architecture with security-first design
- OAuth2 and WebAuthn/Passkey authentication patterns
- Publication-ready development standards
LangChain Redis - Redis integration for LangChain
- Vector database integration patterns
- LangChain ecosystem extension
- Memory and caching strategies for AI applications
mivoa - Next.js 15 app with enforced Firebase abstraction via StorageBackend interface
- StorageBackend interface decouples Firebase from UI layer; enforced import rule ("Nothing in components/ or hooks/ may import from firebase/*")
- Two concrete implementations: production Firebase backend and in-memory local backend for testing without network
- BYOK AI model integration with layered architecture and explicit directory-level enforcement
Web MuJoCo Gym - High-performance WebAssembly machine learning environment
- WebAssembly for high-performance computing
- Physics simulation and reinforcement learning
- Browser-based ML/RL environments
Omar Dulaimi Prisma tRPC Generator - Modern full-stack TypeScript tooling integration
- Multi-tool integration (Prisma + tRPC + Zod)
- Advanced code generation workflows with ts-morph
- Configuration-driven design for type-safe APIs
TrysteroSwift - P2P WebRTC data channels in Swift
- Peer-to-peer networking patterns
- WebRTC implementation in Swift
- Real-time communication protocols
Pydantic GenAI Prices - Expert data processing pipeline patterns
- Pydantic-based data validation and processing
- AI pricing analysis and comparison
- YAML-driven configuration patterns
ReGo - Unified REST API abstraction layer for enterprise services
- Cross-cutting concerns documentation (auth, retry, caching, rate limiting)
- Structured git commit message format specification
- Consistent API patterns across 10+ enterprise service integrations
viral-assemble - Viral genome assembly toolkit from Broad Institute
- Docker-centric development paradigm with container-first workflow
- Command registration pattern for modular assembly pipeline
- Testing performance budgets with slow test markers
msg-rs - Distributed systems messaging library
- Async-first architecture with Tokio integration
- Trait-based extensibility for transport and authentication
- Comprehensive testing strategy including chaos testing
MeFood Next.js - Modern Next.js food application
- Next.js 15 with comprehensive technology stack documentation
- Database-centric architecture with detailed schema descriptions
- Production deployment patterns with PM2 process management
trifle_stats - Multi-database time-series library in Elixir (First Elixir example)
- Unified API across MongoDB, PostgreSQL, SQLite, and Redis
- Fluent API design with Elixir-idiomatic pipeline operations
- Pattern matching excellence for data transformation
Agentic - AI agent orchestration library
- Multi-agent coordination patterns
- TypeScript-based AI agent framework
- Tool integration and workflow management

🔄 Project Handoffs

Documentation focused on project state, blocking issues, and transition planning.

B+ Tree - Data structure implementation with clear handoff documentation
- Kent Beck's development methodology
- Incremental development approach
- Clear documentation of implementation decisions
Mattermost Test Management - Test automation framework with transition documentation
- Enterprise test management patterns
- QA workflow automation
- Team collaboration in testing
Tasker Systems Book - Narrative-driven technical documentation approach
- Revolutionary storytelling with technical depth
- Workflow orchestration using Tasker Rails engine
- Chapter-based development with version control standards

🔧 Tools & Ecosystem

Tools that generate, sync, or manage CLAUDE.md files.

Inclusion criteria: Tools must be directly related to CLAUDE.md workflows. License type is shown for reference.

Tool	Description	License
claude-brain	Sync CLAUDE.md and Claude Code configuration across machines via git hooks	MIT
sourcebook	Generate CLAUDE.md from codebase conventions, constraints, and git forensics	BSL-1.1

Quality Standards

Our collection prioritizes content quality and educational value over popularity metrics:

Primary Criteria (70% weight)

Content Depth - Comprehensive architecture, workflows, and context
Educational Value - Demonstrates unique patterns and best practices
AI Effectiveness - Well-structured for AI assistant consumption

Secondary Criteria (30% weight)

Project Maturity - Active maintenance and production usage
Community Recognition - Industry validation and engagement

Scoring Framework

100-point scale emphasizing content quality
60+ points required for inclusion
Stars contribute only 10% of total score
No hard star minimums - quality content from any repository size

Contributing

We welcome contributions! Here's how to add examples:

Adding New Examples

Search for Quality: Use GitHub search (filename:CLAUDE.md) to find examples
Assess Quality: Ensure examples meet our 60+ point criteria
Create Analysis: Write comprehensive analysis explaining educational value
Update README: Add to appropriate sections with proper categorization

Ethical Guidelines

Never copy CLAUDE.md files directly into this repository
Always link to the original source repository
Include attribution with source links, licensing information, and proper credit
Respect copyright and only reference publicly available files under permissive licenses

Quality Review Process

Automated Discovery finds candidates using enhanced content analysis
Community Review evaluates educational value and uniqueness
Manual Curation ensures alignment with quality standards

Search GitHub

Find more CLAUDE.md examples using these search strategies:

Manual Search Queries

filename:CLAUDE.md "## Architecture"
filename:CLAUDE.md "## Development Commands"
"## Testing" filename:CLAUDE.md
"## Deployment" filename:CLAUDE.md
filename:CLAUDE.md language:TypeScript

KOL and Expert Organization Search

filename:CLAUDE.md user:anthropics - AI experts and Claude creators
filename:CLAUDE.md user:openai - AI research and development
filename:CLAUDE.md user:microsoft - Enterprise AI and infrastructure
filename:CLAUDE.md user:cloudflare - Infrastructure and runtime systems

Domain-Specific Searches

Python Ecosystem: filename:CLAUDE.md user:fastapi OR user:pydantic
JavaScript/React: filename:CLAUDE.md user:vercel OR user:nextjs
AI/ML: filename:CLAUDE.md user:huggingface OR user:langchain-ai
Infrastructure: filename:CLAUDE.md user:docker OR user:kubernetes

Total Examples: 104 | Last Updated: February 2026 | Maintained by: Community Contributors

🤖 This collection is maintained with assistance from Claude Code for quality analysis and curation

Awesome CLAUDE.md