Claudeforge

ClaudeForge

**Automated CLAUDE.md creation, enhancement, and maintenance for Claude Code projects**

[](https://opensource.org/licenses/MIT) [](https://github.com/alirezarezvani/ClaudeForge/releases) [](https://claude.com/claude-code) [](https://github.com/alirezarezvani/ClaudeForge/actions) [](docs/GITHUB_WORKFLOWS.md)

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](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/)

...