ClaudeForge

Автоматическое создание, улучшение и поддержка CLAUDE.md для проектов Claude Code

ClaudeForge — комплексный инструментарий, устраняющий рутину ручного создания и поддержки CLAUDE.md файлов. Благодаря интеллектуальному анализу, автоматической генерации и фоновому обслуживанию ваши CLAUDE.md файлы всегда остаются синхронизированными с кодовой базой.

🆕 Новое в v2.0 (поддержка Claude Code v2.1.4+)

• Lifecycle Hooks: агент-хранитель автоматически проверяет обновления при старте сессии через хуки SessionStart
• Современные разрешения: все компоненты используют синтаксис permissions: для точного управления доступом
• Hot-Reload: скиллы автоматически перезагружаются при изменении (перезапуск не требуется)
• Fork-Safe режим: хранитель работает независимо с fork_safe: true, не блокируя операции
• Определение версии: установщики проверяют версию Claude Code и обеспечивают совместимость
• Авто-миграция: плавное обновление с v1.x с автоматическим созданием резервных копий

👉 Обновляетесь с v1.x? Смотрите docs/MIGRATION_V2.md для руководства по миграции.

✨ Возможности

• 🚀 Интерактивная инициализация — исследует репозиторий, определяет контекст проекта и создаёт кастомизированные CLAUDE.md файлы через диалоговый сценарий
• ✅ Интеллектуальный анализ — сканирует и оценивает существующие CLAUDE.md файлы с качественным скорингом (0–100) и конкретными рекомендациями
• 🔧 Умное улучшение — автоматически добавляет недостающие секции и улучшает структуру
• 🛡️ Фоновое обслуживание — агент-хранитель синхронизирует CLAUDE.md с изменениями в кодовой базе
• 📦 Модульная архитектура — поддерживает сложные проекты с контекстно-специфичными файлами (backend/, frontend/, database/)
• 🎯 100% нативный формат — все генерируемые файлы следуют официальному формату Claude Code: диаграммы структуры проекта, инструкции по настройке, секции архитектуры
• 🛠️ Кастомизация под стек — адаптирует рекомендации под TypeScript, Python, Go, React, Vue, FastAPI и другие технологии
• 👥 Адаптация под размер команды — регулирует сложность в зависимости от размера команды (solo, small, medium, large)

📦 Состав

1. Скилл (claudeforge-skill)

Основная функциональность для анализа, генерации, валидации и улучшения CLAUDE.md

2. Slash-команда (/enhance-claude-md)

Интерактивный интерфейс с многофазным сценарием обнаружения

3. Агент-хранитель (claude-md-guardian)

Фоновый агент для автоматического обслуживания и синхронизации CLAUDE.md

🚀 Быстрый старт

Установка

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

Ручная установка

git clone https://github.com/alirezarezvani/ClaudeForge.git
cd ClaudeForge
./install.sh  # или .\install.ps1 на Windows

Использование

После установки перезапустите Claude Code и выполните:

Всё! Команда выполнит следующее:

1. ✅ Исследует структуру проекта
2. ✅ Определит стек технологий и тип проекта
3. ✅ Покажет результаты и запросит подтверждение
4. ✅ Создаст кастомизированный CLAUDE.md файл (или несколько)
5. ✅ Применит лучшие практики и нативный формат

💡 Сценарии использования

Новый проект (без CLAUDE.md)

/enhance-claude-md

# Claude исследует репозиторий и отвечает:
#
# "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?"
#
# Вы: "Yes"
#
# ✅ CLAUDE.md создан (108 строк)
# ✅ backend/CLAUDE.md создан (156 строк)
# ✅ frontend/CLAUDE.md создан (182 строки)

Существующий проект (требует улучшения)

/enhance-claude-md

# Claude анализирует текущий 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?"
#
# Вы: "Yes"
#
# ✅ CLAUDE.md улучшен (+2 секции, quality score: 65 → 88)

Фоновое обслуживание

# Вы начинаете новую сессию Claude Code
# Агент-хранитель автоматически проверяет изменения
#
# ✅ CLAUDE.md обновлён:
# - Tech Stack: добавлено 2 зависимости (react-query, tailwindcss)
# - Project Structure: диаграмма обновлена с новой директорией components/
# - Setup & Installation: новые переменные окружения
#
# Изменения: 3 секции, 12 строк

📚 Документация