claudeforge

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.

🆕 What's New

• Installable Claude Code plugin — manifest at .claude-plugin/plugin.json; install with /plugin marketplace add alirezarezvani/ClaudeForge && /plugin install claudeforge
• Hard 150-line cap per CLAUDE.md — enforced deterministically by hooks/hooks.json on PostToolUse(Edit|Write) and InstructionsLoaded (every load_reason); larger projects spread content across chained sub-files via @path imports
• /sync-claude-md — walks every CLAUDE.md, prunes stale references, splits when over the cap, repairs root ↔ sub chains
• /sync-claude-md --weekly — orchestrates three forked task-style skills in parallel: claude-md-drift-audit, claude-md-link-check, claude-md-dependency-rescan
• Karpathy behavioural guidelines auto-embedded in every generated CLAUDE.md and installed as a standalone ~/.claude/skills/karpathy-guidelines/ skill scoped to code-file globs
• AGENTS.md / .cursorrules / .windsurfrules interop — /enhance-claude-md detects sibling instruction files and chains them via @-imports instead of overwriting
• CLAUDE.local.md personal tier — per-developer overrides exempt from the cap, gitignored automatically
• Layered hook config — hooks/hooks-config.json (committed defaults) + hooks/hooks-config.local.json (gitignored) lets developers opt out per machine
• Lifecycle hooks: SessionStart, PreToolUse, PostToolUse, InstructionsLoaded, Stop (one-line drift summary at session end)
• Guardian agent runs model: haiku with a fail-closed contract (Skill-tool only, never auto-commits, aborts on missing validated output)

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

✨ 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

Skills