Automated CLAUDE.md creation, enhancement, and maintenance for Claude Code projects
ClaudeForge is a comprehensive toolkit that eliminates the tedious process of manually creating and maintaining CLAUDE.md files. With intelligent analysis, automated generation, and background maintenance, your CLAUDE.md files stay perfectly synchronized with your codebase.
- 🚀 Interactive Initialization - Explores your repository, detects project context, and creates customized CLAUDE.md files through conversational workflow
- ✅ Intelligent Analysis - Scans and evaluates existing CLAUDE.md files with quality scoring (0-100) and actionable recommendations
- 🔧 Smart Enhancement - Adds missing sections and improves structure automatically
- 🛡️ Background Maintenance - Guardian agent keeps CLAUDE.md synchronized with codebase changes
- 📦 Modular Architecture - Supports complex projects with context-specific files (backend/, frontend/, database/)
- 🎯 100% Native Format - All generated files follow official Claude Code format with project structure diagrams, setup instructions, and architecture sections
- 🛠️ Tech Stack Customization - Tailors guidelines to TypeScript, Python, Go, React, Vue, FastAPI, and more
- 👥 Team Size Adaptation - Adjusts complexity based on team size (solo, small, medium, large)
Core capability for CLAUDE.md analysis, generation, validation, and enhancement
Interactive interface with multi-phase discovery workflow
Background agent for automatic CLAUDE.md maintenance and synchronization
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bashiwr https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.ps1 -useb | iexgit clone https://github.com/alirezarezvani/ClaudeForge.git
cd ClaudeForge
./install.sh # or .\install.ps1 on WindowsAfter installation, restart Claude Code and run:
/enhance-claude-mdThat's it! The command will:
- ✅ Explore your project structure
- ✅ Detect tech stack and project type
- ✅ Show discoveries and ask for confirmation
- ✅ Create customized CLAUDE.md file(s)
- ✅ Apply best practices and native format
/enhance-claude-md
# Claude explores your repository and responds:
#
# "Based on my exploration, here's what I discovered:
#
# 📦 Project Type: Full-Stack Application
# 🛠️ Tech Stack: TypeScript, React, Node.js, PostgreSQL, Docker
# 👥 Team Size: Small (5 developers)
# 🚀 Development Phase: MVP
#
# 📋 Recommended Structure:
# - Root CLAUDE.md (navigation hub, ~100 lines)
# - backend/CLAUDE.md (API guidelines, ~150 lines)
# - frontend/CLAUDE.md (React guidelines, ~175 lines)
#
# Would you like me to create these files?"
#
# You: "Yes"
#
# ✅ CLAUDE.md created (108 lines)
# ✅ backend/CLAUDE.md created (156 lines)
# ✅ frontend/CLAUDE.md created (182 lines)/enhance-claude-md
# Claude analyzes your current CLAUDE.md:
#
# "Quality Score: 65/100
#
# Missing Sections:
# - Project Structure (ASCII diagram)
# - Setup & Installation
# - Architecture
#
# Would you like me to enhance your CLAUDE.md with these sections?"
#
# You: "Yes"
#
# ✅ CLAUDE.md enhanced (+2 sections, quality score: 65 → 88)# You start a new Claude Code session
# Guardian agent automatically checks for changes
#
# ✅ CLAUDE.md updated:
# - Tech Stack: Added 2 dependencies (react-query, tailwindcss)
# - Project Structure: Updated diagram with new components/ directory
# - Setup & Installation: New environment variables
#
# Changes: 3 sections, 12 lines| Document | Description |
|---|---|
| Quick Start Guide | 5-minute tutorial to get started |
| Installation Guide | Detailed installation instructions and troubleshooting |
| Architecture Overview | How components work together |
| Troubleshooting | Common issues and solutions |
| Contributing Guide | How to contribute to ClaudeForge |
See the examples/ directory for:
- Basic usage scenarios
- Modular architecture setup
- Integration with existing projects
- Advanced customization
Core Capabilities:
- Analysis - Scans existing CLAUDE.md files for quality and completeness
- Validation - Checks against Anthropic guidelines and best practices
- Generation - Creates new CLAUDE.md files from scratch
- Enhancement - Adds missing sections and improves structure
- Template Selection - Chooses appropriate templates based on project context
Quality Scoring (0-100):
- Length appropriateness (25 pts)
- Section completeness (25 pts)
- Formatting quality (20 pts)
- Content specificity (15 pts)
- Modular organization (15 pts)
Multi-Phase Workflow:
- Discovery - Checks for existing CLAUDE.md, examines project structure
- Analysis - Determines appropriate action (initialize vs. enhance)
- Task - Invokes skill or agent to execute workflow
Background Maintenance:
- Auto-Sync - Updates CLAUDE.md based on detected changes
- Smart Detection - Only updates when significant changes occur
- Token-Efficient - Uses haiku model for routine updates
- Milestone-Aware - Triggers after feature completion, refactoring, etc.
- Claude Code 2.0 or later
- Git (recommended for change detection)
- Operating Systems: macOS, Linux, Windows (PowerShell)
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Bug Reports: GitHub Issues
- Feature Requests: GitHub Discussions
- Documentation: docs/
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright © 2025 Alireza Rezvani
- Built for the Claude Code community
- Inspired by best practices from Anthropic's official documentation
- Special thanks to all contributors and early adopters
Version: 1.0.0 Status: ✅ Stable & Production-Ready Last Updated: November 12, 2025
- 7 reference CLAUDE.md templates included
- 100% native Claude Code format compliance
- 5 Python modules
- 3 integrated components (skill, command, agent)
- 10+ usage examples and scenarios
If you find ClaudeForge helpful, please consider giving it a star on GitHub!
Made with ❤️ for the Claude Code community