ClaudeForge

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.

---

🆕 New in v2.0 (Claude Code v2.1.4+ Support)

• Lifecycle Hooks: Guardian agent automatically checks for updates at session start using SessionStart hooks
• Modern Permissions: All components now use permissions: syntax for fine-grained control
• Hot-Reload: Skills automatically reload when modified (no restart needed)
• Fork-Safe Mode: Guardian runs independently with fork_safe: true without blocking operations
• Version Detection: Installers validate Claude Code version and ensure compatibility
• Auto-Migration: Seamless upgrade from v1.x with automatic backups

👉 Upgrading from v1.x? See docs/MIGRATION_V2.md for migration guide.

---

✨ Features

• 🚀 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)

---

📦 What's Included

1. Skill (claudeforge-skill)

Core capability for CLAUDE.md analysis, generation, validation, and enhancement

2. Slash Command (/enhance-claude-md)

Interactive interface with multi-phase discovery workflow

3. Guardian Agent (claude-md-guardian)

Background agent for automatic CLAUDE.md maintenance and synchronization

---

🚀 Quick Start

Installation

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash

Windows (PowerShell)

iwr https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.ps1 -useb | iex

Manual Installation

git clone https://github.com/alirezarezvani/ClaudeForge.git
cd ClaudeForge
./install.sh  # or .\install.ps1 on Windows

Usage

After installation, restart Claude Code and run:

/enhance-claude-md

That's it! The command will:

1. ✅ Explore your project structure
2. ✅ Detect tech stack and project type
3. ✅ Show discoveries and ask for confirmation
4. ✅ Create customized CLAUDE.md file(s)
5. ✅ Apply best practices and native format

---

💡 Use Cases

New Project (No CLAUDE.md)

/enhance-claude-md

---

*[GitHub에서 전체 내용 보기](https://github.com/alirezarezvani/ClaudeForge)*