Forge

Превратите Claude Code в структурированный цикл доставки: планируйте работу, запускайте модули параллельно, проводите глубокую проверку, выполняйте интеллектуальные повторные попытки и сохраняйте то, что сработало.

Установка

Скопируйте и вставьте:

claude plugin marketplace add TT-Wang/forge
claude plugin install forge@tt-wang-plugins

Первый запуск может занять несколько секунд, так как Forge автоматически загружает зависимости своего MCP-сервера.

После установки:

1. перезапустите Claude Code, если он был открыт

2. откройте любой репозиторий, в котором хотите работать

3. выполните /forge <objective>

Пример:

/forge add audit logging for admin actions

Related MCP server: KIA - Kaizen Intelligent Agent

Идея

Forge предназначен для тех случаев, когда обычных промптов становится недостаточно.

Если задача затрагивает несколько файлов, требует координации между модулями или доказательства того, что всё действительно работает, Forge предоставляет Claude Code рабочий процесс вместо очередного промпта:

• разбиение работы на модули

• запуск того, что можно распараллелить

• тщательная проверка каждого модуля

• повторные попытки при сбоях с использованием контекста отладчика

• запоминание того, что сработало, для следующей задачи

Вы по-прежнему используете Claude Code. Forge просто добавляет структуру вокруг сложных частей.

Что вы получаете

• Структурированное планирование: разбивает функцию на модули с зависимостями и командами проверки

• Параллельное выполнение: запускает независимые модули одновременно в изолированных рабочих деревьях

• Глубокая проверка: проверяет файлы, команды, синтаксис и контракты API между модулями

• Интеллектуальный повтор: отслеживает попытки, обнаруживает застой и передает задачу агенту-отладчику

• Возобновляемость сессий: продолжает незавершенную работу, а не начинает с нуля

• Память между сессиями: запоминает соглашения, шаблоны сбоев и команды тестирования

• Видимость статуса: отображает прогресс в выводе Claude и строке состояния терминала

Почему не использовать Claude Code напрямую?

Для многих задач — стоит.

Forge не пытается заменить обычное использование. Он предназначен для задач, где важна оркестрация.

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

60-секундная настройка

1. Установите Forge с помощью двух команд выше

2. Перезапустите Claude Code

3. Откройте свой проект

4. Вставьте цель:

/forge add JWT auth with refresh tokens

5. Одобрите созданный план

Запуск

/forge build an audit log for admin actions

Проверка прогресса

/forge-status

Повторная проверка одного модуля

/forge-validate m2

Типичная сессия

/forge add JWT auth with refresh tokens

[forge] Phase 1: Planning...
[forge] Proposed Plan: 4 modules, 2 parallel groups
[forge] Proceed with this plan? (yes / modify / abort)

[forge] Phase 2: Executing m1...
[forge] Phase 2: Executing m2, m3 in parallel...
[forge] ✓ m2: DONE — validated, score 1.0
[forge] ✗ m3: FAILED — retrying with debugger
[forge] ✓ m3: DONE — validated after retry

[forge] ## Forge Complete
[forge] 4/4 modules completed

Это тот опыт, к которому стремится Forge: меньше ручного управления, больше видимого прогресса и меньше скрытых сбоев.

Чего ожидать при первом запуске

• Forge создаст локальную директорию .forge/ в вашем проекте

• MCP-сервер может потратить несколько секунд на установку своих Node-зависимостей

• ваше первое реальное взаимодействие — это этап проверки плана

• ничего не выполняется, пока вы явно не одобрите план

Текущая структура проекта

forge/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .claude/
│   ├── settings.json
│   └── settings.local.json
├── agents/
│   ├── planner.md
│   ├── worker.md
│   ├── reviewer.md
│   └── debugger.md
├── skills/
│   ├── forge/
│   │   └── SKILL.md
│   ├── forge-status/
│   │   └── SKILL.md
│   └── forge-validate/
│       └── SKILL.md
├── forge-mcp-server/
│   ├── index.mjs
│   ├── start.sh
│   ├── package.json
│   └── tests/
├── statusline/
│   └── forge-status.sh
├── docs/
│   ├── architecture.md
│   ├── mcp-tools.md
│   └── launch/
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
├── CLAUDE.md
└── README.md

Во время выполнения Forge также создает локальную директорию .forge/ в рабочем проекте для хранения планов, логов, памяти, истории повторов и возобновляемого состояния.

Основные компоненты

Агенты

Forge поставляется с четырьмя специализированными агентами:

• planner: исследует кодовую базу и предлагает план модулей

• worker: реализует один модуль в изолированном рабочем дереве

• reviewer: проверяет корректность, безопасность и несоответствия контрактов

• debugger: исследует сбойные модули и управляет повторными попытками

Навыки

Команды для пользователя:

• /forge: полный рабочий процесс оркестратора

• /forge-status: текущий план, прогресс модулей и изученные шаблоны

• /forge-validate: повторный запуск проверки для одного модуля

MCP-сервер

Входящий в комплект MCP-сервер предоставляет общие возможности среды выполнения, необходимые Forge:

• validate

• validate_plan

• memory_recall

• memory_save

• iteration_state

• forge_logs

• session_state

Эти инструменты позволяют нескольким агентам координироваться, не полагаясь на слабую разговорную память.

Строка состояния

Forge может отображать прогресс в реальном времени в вашем терминале:

[forge] ████░░░░░░ 2/5 | VALIDATE | refresh endpoint | 3m19s | ~2m30s left

Чтобы использовать её:

claude statusline set "bash /path/to/forge/statusline/forge-status.sh"

Что находится в вашем проекте

Forge хранит состояние выполнения в локальной директории .forge/ внутри рабочего проекта. Это включает:

• планы выполнения

• историю повторов

• изученные шаблоны

• структурированные логи

• возобновляемое состояние сессии

Это делает рабочий процесс прозрачным, а не скрытым за непрозрачным состоянием агента.

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

• Архитектура — оркестратор, агенты, MCP-сервер и поток состояния

• Справочник инструментов MCP — схемы ввода/вывода и примеры для всех 7 инструментов

• Журнал изменений — примечания к выпуску

• Участие в разработке — настройка среды, тесты, линтинг и процесс PR

• Безопасность — отчеты об уязвимостях и область безопасности

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

Если вы не хотите устанавливать из маркетплейса Claude Code, вы можете настроить Forge вручную:

git clone https://github.com/TT-Wang/forge.git /tmp/forge
mkdir -p .claude/agents .claude/skills
cp /tmp/forge/agents/*.md .claude/agents/
cp -r /tmp/forge/skills/* .claude/skills/
cp -r /tmp/forge/forge-mcp-server ./forge-mcp-server/
cd forge-mcp-server && npm install && cd ..

Затем подключите MCP-сервер, используя эталонную конфигурацию в .claude/settings.json.

Разработка

git clone https://github.com/TT-Wang/forge.git
cd forge/forge-mcp-server
npm install
npm test

Отлично работает с

• memem — постоянная память между сессиями для Claude Code. Forge занимается планированием и выполнением; memem помогает переносить полезные шаблоны между запусками.

• Vibereader — курируемые технические новости, пока Claude работает

Лицензия

MIT — см. LICENSE