ClaudeForge — плагин
Плагин Claude Code создает и поддерживает CLAUDE.md: оценка от 0 до 100, лимит 150 строк и проверка устаревших ссылок
- 430 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки запускают скрипты на Python при каждой записи и правке файлов и при загрузке инструкций
- Команды создают, делят и перезаписывают файлы CLAUDE.md и AGENTS.md в проекте, а установка скриптом выполняет код, скачанный из сети
Установка
- Работает в
Ручная установка
/plugin marketplace add alirezarezvani/ClaudeForgeПервый шаг: добавить каталог плагина в сессии Claude Code.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки запускают скрипты на Python при каждой записи и правке файлов и при загрузке инструкций
- Команды создают, делят и перезаписывают файлы CLAUDE.md и AGENTS.md в проекте, а установка скриптом выполняет код, скачанный из сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ClaudeForge создает, улучшает и поддерживает файлы CLAUDE.md в проектах Claude Code. Команда /enhance-claude-md исследует репозиторий через подагента Explore, определяет стек, тип проекта и размер команды. Она показывает находки и после вашего подтверждения пишет файлы. Для проекта из нескольких частей получается корневой CLAUDE.md и вложенные файлы для серверной и клиентской частей. Существующий файл скилл оценивает по шкале от 0 до 100: длина, полнота разделов, форматирование, конкретность и модульность. Лимит в 150 строк на файл держит хук на событиях PostToolUse и InstructionsLoaded: при превышении сценарий проверки возвращает ошибку, а крупный проект разносится по подфайлам через импорты @path. Команда /sync-claude-md проходит по всем CLAUDE.md, убирает устаревшие ссылки, делит слишком длинные файлы и чинит цепочки. С флагом --weekly она параллельно запускает три аудита: claude-md-drift-audit, claude-md-link-check и claude-md-dependency-rescan. Команда /claude-to-agents превращает дерево CLAUDE.md в AGENTS.md для Codex, Gemini Code Assist и других инструментов: символической ссылкой, копией или одним файлом с развернутой цепочкой импортов. Агент claude-md-guardian работает на модели «haiku» и следит за соответствием файла коду. Сам он ничего не коммитит и прерывается, если нет проверенного результата.
Для кого. Для разработчиков и команд, которые ведут проекты в Claude Code и хотят держать CLAUDE.md короткими, актуальными и в соответствии с практиками Anthropic для Claude Code.
Подходит, если
- В проекте нет CLAUDE.md: /enhance-claude-md исследует репозиторий и создаст файл под ваш стек
- CLAUDE.md разросся, устарел или ссылается на удаленные пути: /sync-claude-md уберет лишнее и разделит файл
- Рядом лежат AGENTS.md, .cursorrules или .windsurfrules: команда связывает их через импорты вместо перезаписи
- Из дерева CLAUDE.md нужен AGENTS.md для Codex или Gemini: для этого есть /claude-to-agents
- Раз в неделю нужен аудит расхождений с кодом, битых ссылок и зависимостей: /sync-claude-md --weekly
Не подходит, если
- Правила нужны для одной задачи без постоянного файла: плагин рассчитан на долгоживущие CLAUDE.md
- Вы не работаете в Claude Code: хуки и команды плагина привязаны к нему
- Вам мешает жесткий лимит: хук не пропускает файлы длиннее 150 строк, исключение есть только у *.local.md
- Вы не готовы запускать скрипт установки, который скачивается и выполняется сразу: есть установка через /plugin
Пример запроса к агенту
Запусти /enhance-claude-md и создай CLAUDE.md для моего проекта на TypeScript, React и PostgreSQL, сначала покажи найденный стек и структуру файловОграничения
Нужен Claude Code версии 2.1.4 или новее. Лимит в 150 строк на CLAUDE.md проверяют хуки, поэтому большие проекты приходится делить на подфайлы с импортами @path. Файл CLAUDE.local.md для личных настроек лимитом не ограничен и попадает в .gitignore автоматически. Codex и Gemini не разворачивают импорты @, поэтому для модульных проектов при переносе в AGENTS.md рекомендован режим --inline-chain. В каждый созданный CLAUDE.md встраиваются четыре принципа Karpathy: подумать до кода, простота, точечные правки и исполнение до цели. Основной скилл и агент-хранитель работают на модели «haiku». Claude Code зависит от API Anthropic, которые из России недоступны.
Как отключить. Удалите плагин через меню /plugin или, при установке скриптом, файлы, которые положил install.sh. На своей машине хуки можно отключить в hooks/hooks-config.local.json, этот файл не попадает в git.
Частые вопросы
Как поставить ClaudeForge в Claude Code?
Плагин ставится двумя командами /plugin прямо в сессии Claude Code: добавлением каталога и установкой. Плагин ставит скиллы, команды и агента-хранителя, при установке на уровне пользователя они доступны во всех проектах. После перезапуска вызовите /enhance-claude-md.
Как работает лимит в 150 строк и как его обойти?
Хук проверяет файл при записи и при загрузке инструкций и возвращает ошибку, если строк больше 150. Крупный проект делят на подфайлы с импортами @path. Файлы *.local.md под лимит не попадают. Отключить хук лично для себя можно в hooks-config.local.json.
Как использовать ClaudeForge вместе с Codex и Gemini?
Команда /claude-to-agents собирает из дерева CLAUDE.md файл AGENTS.md в одном из трех режимов: --symlink (по умолчанию на macOS и Linux), --copy и --inline-chain. Для модульных проектов советуют --inline-chain, потому что Codex и Gemini не разворачивают импорты @. Прежний AGENTS.md перед перезаписью копируется в резерв.
Что проверяют три аудит-скилла?
Drift-audit смотрит историю git за последние дни и отмечает строки, которые ссылаются на удаленные или переименованные пути и убранные зависимости. Link-check проверяет, что все импорты @path и относительные ссылки в каждом CLAUDE.md ведут куда-то. Dependency-rescan сверяет зависимости из package.json, requirements.txt, pyproject.toml, go.mod и Cargo.toml с разделом Tech Stack. Все три только читают.
Может ли агент claude-md-guardian что-то закоммитить?
Нет. Он прерывается, если нет проверенного результата, и сам ничего не коммитит. Локальный файл hooks-config.local.json он тоже учитывает.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныНабор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Matt Pocock skills: скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Правила для Claude Code по мотивам Карпаты
Karpathy-Inspired Claude Code Guidelines
Четыре принципа в одном CLAUDE.md против типичных ошибок LLM в коде: допущения, переусложнение, лишние правки
Плагин и скилл, который заставляет агента писать минимум кода: сначала повторное использование, stdlib и нативные возможности
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Набор скиллов Гэрри Тана, превращающий Claude Code в виртуальную команду: продукт, архитектура, дизайн, ревью, QA и выпуск
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ClaudeForge (эта запись) | нет | 430 | |
| Caliber | нет | 1 310 | консольная утилита создает и поддерживает файлы контекста сразу для нескольких агентов: CLAUDE.md, правила Cursor, AGENTS.md и инструкции Copilot |
| agnix | да | 457 | линтер файлов CLAUDE.md, AGENTS.md, SKILL.md, хуков и конфигов MCP с автоисправлением |
Коротко о README
Страница открывается блоком новинок второй версии: манифест плагина, жесткий лимит, команда синхронизации, принципы Karpathy и слоистая настройка хуков. Дальше перечислены состав набора (пять скиллов, три команды, агент, хуки), способы установки, сценарии для нового и существующего проекта, документация и примеры.