Skip to content
/ awesome-claude-md Public

Curated collection of exemplary claude.md files and onboarding patterns from public GitHub projects. Includes analyses, best practices, and templates to help developers create effective AI onboarding documentation for their codebases.

62 stars 7 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

josix/awesome-claude-md

BranchesTags

Repository files navigation

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

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

📋 Table of Contents

🧭 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:
    • Stars Repository popularity
    • License Legal information
    • Activity 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 Badges Why It's Great Tech Stack
OpenAI Agents Python Stars License Activity Official OpenAI multi-agent framework Python, Multi-Agent Systems
Basic Memory Stars License Activity Cutting-edge MCP integration & AI collaboration Python, FastAPI, SQLAlchemy
Overreacted.io Stars License Activity Technical depth with personality Next.js, React, MDX
Pydantic GenAI Prices Stars License Activity Expert data processing pipeline patterns Python, Pydantic, YAML

🥈 Advanced Patterns

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

🔍 Browse by Technology

🟦 TypeScript/JavaScript (28 examples)
🟧 Python (20 examples)
🟫 Rust (7 examples)
🔶 Java (1 example)
🟢 Go (2 examples)
  • GoMall Stars License - RIPER-5 AI methodology
  • Sentry Stars License - Multi-language error tracking platform
🔵 Swift (3 examples)
🟨 Other Languages (9 examples)

Elixir

  • trifle_stats Stars License - First Elixir example - Multi-database time-series library

Kotlin

Node.js (C++)

  • HWP Stars License - Node.js HTTP benchmarking

Smalltalk

  • B+ Tree Stars License - Smalltalk data structure implementation

Haskell

Python (Type Generation)

PHP/Vue.js

  • WindPress Stars License - Vue.js with WebAssembly Tailwind compilation

C#/.NET

Markdown/Documentation

🎨 Browse by Use Case

🤖 Advanced AI Development (12 examples)
🏗️ Infrastructure Projects (5 examples)
🌐 Web3 & Blockchain (4 examples)
🧪 Testing & Quality (1 example)
⚡ High Performance Computing (3 examples)
🚀 Getting Started (4 examples)

📂 All Categories

🏢 Complex Projects

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

  • Citadel Protocol Contracts Stars License Activity - 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 Stars License Activity - AI-guided meta-repository framework

    • 17-module meta-repository architecture
    • Progressive context loading for AI assistants
    • XML-structured prompt engineering system

  • WhereAmI Stars License Activity - SvelteKit location-based social application

    • SvelteKit with Svelte 5 architecture
    • Real-time geolocation and social features
    • Modern full-stack development patterns

  • TimeWarp Architecture Stars License Activity - Blazor WebAssembly clean architecture framework

    • CQRS with MediatR patterns
    • Blazor WebAssembly for high-performance web applications
    • Clean architecture principles

  • Basic Memory Stars License Activity - Cutting-edge MCP integration & AI collaboration

    • MCP-first architecture patterns
    • AI-native development workflows
    • Advanced memory management for AI systems

  • Web Builder Stars License Activity - 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 Stars License Activity - Dan Abramov's technical blog with exceptional documentation

    • Technical depth with personality
    • Complete development workflow
    • Advanced MDX features and static site generation

  • Claude Flow Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - Multi-language error tracking and performance monitoring

    • Cross-platform error tracking system
    • Real-time monitoring and alerting
    • Comprehensive debugging and performance insights

  • Web Monitoring Stars License Activity - Enterprise Flask/Vue.js monitoring system

    • Full-stack monitoring architecture
    • Real-time performance tracking
    • Comprehensive dashboard and alerting system

  • Semantic Workbench Stars License Activity - Microsoft AI assistant platform

    • Enterprise-scale AI assistant development platform
    • Multi-modal AI interaction patterns
    • Professional deployment and scaling strategies

  • Nine Week Challenge Stars License Activity - Next.js 14 wellness tracking application

    • App Router with server components
    • Real-time progress tracking
    • Modern React patterns with TypeScript

  • Webhook Broker Stars License Activity - Event-driven microservice architecture

    • Scalable webhook processing system
    • Event-driven architecture
    • Message queuing patterns

  • OpenAI Agents Python Stars License Activity - Official OpenAI multi-agent framework

    • Official OpenAI documentation patterns
    • Multi-agent architecture and coordination
    • Enterprise-grade AI system design

  • Platformatic Stars License Activity - Node.js application platform

    • Full-stack Node.js development platform
    • Database-to-API automation
    • Plugin-based architecture

  • WindPress Stars License Activity - Vue.js with WebAssembly Tailwind compilation

    • In-browser CSS compilation using WebAssembly
    • WordPress plugin development patterns
    • Modern Vue.js Composition API with TypeScript

🛠️ Developer Tooling

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

  • MCP WordPress Stars License Activity - MCP server for WordPress CMS integration

    • Model Context Protocol server development
    • Multi-site WordPress management patterns
    • Security-first architecture with data sanitization

  • OpenFeign QueryDSL Stars License Activity - 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 Stars License Activity - State machine workflow orchestration

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

  • HA Irrigation Strategy Stars License Activity - 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 Stars License Activity - Monorepo management and edge computing development

    • Comprehensive monorepo patterns
    • Edge computing development workflows
    • Testing and deployment strategies

  • Kargo Stars License Activity - Knowledge graphs and information retrieval

    • Graph-based data management
    • Information retrieval and processing
    • AI-powered knowledge organization

  • Claude Crew Stars License Activity - Strict TypeScript development standards

    • Code quality enforcement
    • TypeScript best practices
    • Development workflow optimization

  • Swift Law Stars License Activity - Domain-specific legal AI assistant

    • Context-bounded RAG architecture for legal documents
    • Professional AI deployment patterns
    • Domain-specific validation techniques

  • Kotlinter Gradle Stars License Activity - Kotlin linting and formatting plugin

    • Gradle plugin development patterns
    • Code quality automation
    • Kotlin development best practices

  • Image Generation MCP Stars License Activity - MCP server for AI image generation

    • MCP protocol implementation
    • Cloudflare Workers deployment
    • AI service integration patterns

  • Jason Liu Blog Stars License Activity - AI/ML thought leadership and technical blogging

    • Technical content creation workflows
    • AI/ML best practices and insights
    • Professional development documentation

  • Kubb Stars License Activity - OpenAPI TypeScript generator

    • Code generation from OpenAPI specifications
    • TypeScript tooling development
    • API client generation patterns

  • Lerna Stars License Activity - Monorepo management tool

    • Multi-package repository management
    • Version management and publishing
    • JavaScript ecosystem tooling

  • GoMall Stars License Activity - RIPER-5 AI methodology for Go development

    • AI-driven development methodology
    • Go microservices architecture
    • E-commerce platform patterns

  • Context Creator Stars License Activity - AI-optimized codebase analysis tool

    • Automated codebase analysis for AI assistants
    • Context generation and optimization
    • Development workflow enhancement

  • HWP Stars License Activity - HTTP benchmarking and performance testing

    • Performance testing methodologies
    • HTTP benchmarking tools
    • Node.js performance optimization

  • macMCP Stars License Activity - 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 Stars License Activity - SVG optimization and compression tool

    • Graphics optimization algorithms
    • Command-line tool development
    • Performance-focused design

  • OpenShift ROSA Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - Systematic development framework

    • 6-phase development workflow methodology
    • Testing-driven development with comprehensive validation
    • Rust-based development tools and frameworks

  • PyTorch tlparse Stars License Activity - Log parsing and analysis tool

    • Dual-language (Rust/Python) architecture
    • Performance-critical log processing
    • ML/AI debugging and optimization

  • claude-code-mastra Stars License Activity - 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 Stars License Activity - Rust workflow orchestration engine

    • Advanced workflow orchestration patterns
    • Testing-driven development methodology
    • High-performance task processing

  • mypy-boto3-builder Stars License Activity - AWS SDK type stubs generator

    • Type stub generation for Python
    • AWS integration patterns
    • Developer tooling for cloud services

  • SummaryBot NG Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - Full-stack TypeScript application

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

🚀 Getting Started

Projects focused on developer onboarding and initial setup experiences.

  • Anthropic Quickstarts Stars License Activity - 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 Stars License Activity - Official Ethereum community website (5,000+ stars)

    • Community-driven development
    • Multi-language support
    • Documentation workflows

  • KleverConnect Starter Stars License Activity - Web3 React + Vite starter kit

    • Klever Wallet integration patterns
    • Custom hook design for Web3
    • TypeScript-first blockchain development

  • Dotfiles Stars License Activity - Personal development environment configuration

    • Comprehensive collaboration guidelines for AI assistant integration
    • Personal dotfiles with extensive tool configuration patterns
    • Detailed working parameters and communication preferences

🏗️ Infrastructure Projects

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

  • Cloudflare Workerd Stars License Activity - JavaScript runtime for Cloudflare Workers

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

  • TrailOfBits Algo Stars License Activity - 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 Stars License Activity - Infrastructure automation with MCP integration

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

  • Demo MCP Stars License Activity - 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.

  • Callstack React Native Testing Stars License Activity - 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 Stars License Activity - Blockchain SDK for TypeScript development

    • Chaincode development patterns with TypeScript
    • Multi-level testing strategy (unit, integration, e2e)
    • Modular SDK architecture for blockchain applications

  • Composio Stars License Activity - AI agent integration platform

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

  • PMStander Web Tools Stars License Activity - 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 Stars License Activity - Privacy-focused data processing library

    • Privacy-preserving data processing
    • Data anonymization and protection
    • GDPR compliance patterns

  • mdx-prompt Stars License Activity - LLM prompt engineering components

    • MDX-based prompt engineering
    • Component-driven prompt design
    • React integration for AI applications

  • GenSX Stars License Activity - AI-powered scientific computing framework

    • Scientific computing with AI integration
    • Research and development patterns
    • Data analysis and visualization

  • noren Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - Haskell bindings for PipeWire audio system

    • Functional programming patterns for audio systems
    • C library integration in Haskell
    • Real-time audio processing

  • OAuth2 Passkey Stars License Activity - Modern authentication library

    • Layered library architecture with security-first design
    • OAuth2 and WebAuthn/Passkey authentication patterns
    • Publication-ready development standards

  • LangChain Redis Stars License Activity - Redis integration for LangChain

    • Vector database integration patterns
    • LangChain ecosystem extension
    • Memory and caching strategies for AI applications

  • Web MuJoCo Gym Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - P2P WebRTC data channels in Swift

    • Peer-to-peer networking patterns
    • WebRTC implementation in Swift
    • Real-time communication protocols

  • Pydantic GenAI Prices Stars License Activity - Expert data processing pipeline patterns

    • Pydantic-based data validation and processing
    • AI pricing analysis and comparison
    • YAML-driven configuration patterns

  • msg-rs Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - 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 Stars License Activity - Data structure implementation with clear handoff documentation

    • Kent Beck's development methodology
    • Incremental development approach
    • Clear documentation of implementation decisions

  • Mattermost Test Management Stars License Activity - Test automation framework with transition documentation

    • Enterprise test management patterns
    • QA workflow automation
    • Team collaboration in testing

  • Tasker Systems Book Stars License Activity - Narrative-driven technical documentation approach

    • Revolutionary storytelling with technical depth
    • Workflow orchestration using Tasker Rails engine
    • Chapter-based development with version control standards

Quality Standards

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

Primary Criteria (70% weight)

  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

Secondary Criteria (30% weight)

  1. Project Maturity - Active maintenance and production usage
  2. 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

  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

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

  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

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: 73 | Last Updated: January 2025 | Maintained by: Community Contributors

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

About

Curated collection of exemplary claude.md files and onboarding patterns from public GitHub projects. Includes analyses, best practices, and templates to help developers create effective AI onboarding documentation for their codebases.

Resources

Readme

Contributing

Contributing
Activity

Stars

62 stars

Watchers

0 watching

Forks

7 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 5

Languages