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

Filter by Language: TypeScript/JS | Python | Rust | Go | Swift | Other Filter by Purpose: AI Development | Infrastructure | Web3/Blockchain | High Performance | Getting Started

• 🎯 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
• 🏆 Quality Standards - Our selection criteria
• 🤝 Contributing - How to add examples
• 🔎 Search GitHub - Find more examples

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

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

Example	Badges	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

Example	Badges	Why It's Great	Tech Stack
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

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

• 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

• 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

• 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

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

• SDLC Engine - State machine workflow orchestration

  • Comprehensive workflow automation
  • State machine patterns for software development
  • Testing-driven development methodology

• 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

• 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

• 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

• 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

• 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

• 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

• 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

• Yutodo - Full-stack TypeScript application

  • Comprehensive testing infrastructure with 6 testing methodologies
  • Full-stack development patterns
  • Modern TypeScript development practices

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

• 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

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

• Cloudflare Workerd - JavaScript runtime for Cloudflare Workers

  • High-performance JavaScript runtime built in Rust
  • Edge computing platform architecture
  • V8 engine integration patterns

• Ansible MCP Server - Infrastructure automation with MCP integration

  • Ansible automation with MCP protocol
  • Infrastructure as code patterns
  • DevOps workflow automation

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

• Composio - AI agent integration platform

  • Multi-tool AI agent ecosystem
  • Integration framework for AI assistants
  • Comprehensive API and tooling support

• 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

• 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

• 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

• Web MuJoCo Gym - High-performance WebAssembly machine learning environment

  • WebAssembly for high-performance computing
  • Physics simulation and reinforcement learning
  • Browser-based ML/RL environments

• 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

• Agentic - AI agent orchestration library

  • Multi-agent coordination patterns
  • TypeScript-based AI agent framework
  • Tool integration and workflow management

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

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

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

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

• 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

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

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

• 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

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

Find more CLAUDE.md examples using these search strategies:

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

• 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

• 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: 51 | Last Updated: August 2025 | Maintained by: Community Contributors

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