Forgeplan поставляется с 73 инструментами MCP, которые агент ИИ может вызывать через Model Context Protocol (транспорт stdio).
Запустите сервер MCP:
Настройте своего агента (Claude Code, Cursor и т. д.) для подключения, затем вызовите любой из перечисленных ниже инструментов.
| Инструмент | Описание |
|---|
forgeplan_export | Экспортирует все артефакты и связи в JSON-пакет. Возвращает экспортированные данные напрямую для программного использования или записывает их по указанному пути к файлу. |
forgeplan_import | Импортирует артефакты и связи из JSON-пакета экспорта. Установите force=true, чтобы перезаписать существующие артефакты. |
forgeplan_init | Инициализирует новое рабочее пространство .forgeplan/. Создает таблицы LanceDB, конфигурацию и подкаталоги артефактов. |
| Инструмент | Описание |
|---|
forgeplan_capture | Захватывает решение из беседы в артефакт Note или ADR. Автоматически определяет тип: простые решения становятся Note, архитектурные решения - ADR. Требуется провайдер LLM. |
forgeplan_generate | Генерирует артефакт с помощью ИИ из описания на естественном языке. Требуется провайдер LLM, настроенный в .forgeplan/config.yaml. Поддерживает OpenAI, Claude, Gemini, Ollama и любую совместимую с OpenAI конечную точку. |
forgeplan_new | Создает новый артефакт из шаблона. Генерирует последовательный ID (например, PRD-001), рендерит шаблон, сохраняет в LanceDB и записывает проекцию в формате Markdown. |
| Инструмент | Описание |
|---|
forgeplan_blocked | Показывает заблокированные артефакты и их неудовлетворенные зависимости. Блокируют только черновики артефактов - устаревшие и замещённые считаются разрешенными. Использует только структурные связи (based_on, refines, supersedes, contradicts). |
forgeplan_get | Считывает полный артефакт по ID. Возвращает все метаданные и содержимое тела. |
forgeplan_graph | Генерирует граф зависимостей Mermaid для всех связанных артефактов. Включает явные связи и рёбра belongs_to из parent_epic. |
forgeplan_journal | Показывает журнал решений - хронологическую временную шкалу артефактов ADR, Note, Problem, Solution с оценками R_eff и статусом доказательств. |
forgeplan_list | Выводит список артефактов с необязательными фильтрами по типу/статусу. Возвращает ID, тип, статус и заголовок для каждого артефакта. |
forgeplan_order | Показывает артефакты в топологическом порядке (порядке зависимостей). Возвращает упорядоченный список, классификацию на готовые/заблокированные и обнаружение циклов. Использует только структурные связи. |
forgeplan_progress | Показывает прогресс выполнения артефактов на основе чекбоксов. Анализирует чекбоксы Markdown (- [ ] / - [x]) и вычисляет проценты завершения. |
forgeplan_search | Умный поиск по артефактам: поиск по ключевым словам BM25 + опциональный семантический поиск + расширение графа. Поддерживает фильтры по типу/статусу/глубине/доказательствам/дате и переключение расширения графа. |
forgeplan_session | Показывает текущее состояние сессии методологии - фазу (idle/routing/shaping/coding/evidence/pr), активный артефакт, глубину, статус принудительного применения. Используйте, чтобы знать, на каком этапе рабочего процесса вы находитесь. |
| Инструмент | Описание |
|---|
forgeplan_delete | Удаляет артефакт из LanceDB и удаляет его файл проекции markdown. |
forgeplan_link | Связывает два артефакта типизированным отношением. Допустимые типы: informs, based_on, supersedes, contradicts, refines. |
forgeplan_update | Обновляет метаданные артефакта (статус, заголовок) и/или тело. Перерисовывает проекцию markdown после обновления. |
| Инструмент | Описание |
|---|
forgeplan_calibrate | Предлагает уровень глубины (Tactical/Standard/Deep/Critical) для артефактов на основе анализа содержимого. Обнаруживает разделы безопасности, критические изменения, количество ссылок, сложность содержимого. |
forgeplan_coverage | Показывает покрытие решений по модулю кода - какие модули имеют архитектурные решения, а какие являются слепыми пятнами. |
forgeplan_decay | Показывает влияние устаревания доказательств на оценки R_eff. Перечисляет артефакты, где просроченные доказательства снизили оценки качества, со сравнением текущего и обновлённого R_eff. |
forgeplan_drift | Проверяет дрейфующие решения - затронутые файлы, которые изменились после создания ADR/RFC. |
forgeplan_estimate | Оценивает трудозатраты для артефакта на основе пунктов FR и этапов реализации. Возвращает разбивку по грейдам (Junior/Middle/Senior/Principal/AI) с оценкой достоверности. |
forgeplan_guard | Проверяет, разрешён ли переход между фазами методологии. Используйте перед выполнением действий, чтобы избежать заблокированных операций. Пример: могу ли я перейти от ‘shaping’ к ‘coding’? Возвращает allowed=true/false с указанием причины. |
forgeplan_review | Проверяет артефакт - запускает валидацию и показывает контрольный список жизненного цикла. Показывает результаты MUST/SHOULD и готовность артефакта к активации. |
forgeplan_score | Вычисляет показатель качества R_eff для артефакта на основе связанных доказательств. R_eff использует принцип слабого звена: показатель = min(показатели_доказательств). |
forgeplan_stale | Обнаруживает просроченные артефакты с истёкшими датами valid_until. Возвращает список просроченных артефактов с указанием количества дней с момента истечения срока. |
forgeplan_validate | Валидирует полноту артефакта в соответствии с правилами схемы. Проверяет обязательные разделы для каждого типа артефакта и уровня глубины. Возвращает структурированные результаты с указанием серьёзности (MUST/SHOULD/COULD). |
| Инструмент | Описание |
|---|
forgeplan_activate | Активирует артефакт (draft → active). Требует прохождения всех правил валидации MUST. |
forgeplan_deprecate | Отменяет артефакт (active → deprecated) с указанием причины. |
forgeplan_supersede | Замещает артефакт (active → superseded). Создаёт ссылку на замену и уведомляет зависимые элементы. |
| Инструмент | Описание |
|---|
forgeplan_decompose | Декомпозирует PRD на задачи RFC с помощью ИИ. Анализирует функциональные требования и предлагает 3-7 RFC с заголовками, описаниями, областью действия и зависимостями. Требует провайдера LLM. |
forgeplan_reason | Анализирует артефакт с использованием цикла рассуждений FPF ADI: Абдукция (3+ гипотезы) → Дедукция (оценка каждой) → Индукция (синтез рекомендации). Требует провайдера LLM. |
forgeplan_route | Предлагает уровень глубины (Tactical/Standard/Deep/Critical) и конвейер артефактов для описания задачи. Использует классификацию LLM (Уровень 1), если ключ API настроен, в противном случае возвращается к классификации на основе правил по ключевым словам (Уровень 0). |
| Инструмент | Описание |
|---|
forgeplan_blindspots | Показывает слепые пятна - решения (PRD/RFC/ADR/Epic) без связанных доказательств, а также сироты (артефакты без связей). |
forgeplan_health | Показывает дашборд состояния проекта - пробелы, риски, слепые пятна, сироты, просроченные доказательства и рекомендуемые дальнейшие действия. LLM не требуется. |
forgeplan_status | Показывает дашборд статуса проекта - общее количество артефактов, количество по типу и статусу. |
| Инструмент | Описание |
|---|
forgeplan_fpf_check | Оценивает, какие правила FPF применяются к данному артефакту, показывая все совпавшие правила, выигрышное правило (первое в порядке приоритета, как и во время выполнения) и правила, которые не совпали. Используйте, чтобы понять поведение движка FPF для конкретного артефакта перед принятием действий. |
forgeplan_fpf_list | Перечисляет все доступные разделы базы знаний FPF (First Principles Framework). |
forgeplan_fpf_rules | Перечисляет активные правила FPF из рабочего пространства. По умолчанию возвращает все правила с полными деревьями условий и сообщениями. Параметры позволяют фильтровать: action (EXPLORE/INVESTIGATE/EXPLOIT) для показа только правил этой категории; name для получения одного правила по имени; summary: true для получения только name/priority/action без деталей условий; source (config/default) для отладки активного источника правил. Если в .forgeplan/config.yaml определены пользовательские правила в fpf.rules, они имеют приоритет; в противном случае используются встроенные значения по умолчанию. |
forgeplan_fpf_search | Поиск по базе знаний FPF (First Principles Framework). По умолчанию используется поиск по ключевым словам. Передайте semantic: true для поиска по векторному сходству через эмбеддинги BGE-M3 (требуется функция сборки semantic-search). Если semantic: true передано, но функция не скомпилирована, запрос корректно возвращается к поиску по ключевым словам, и ответ включает поле warning. Примечание: первое обращение с semantic: true может занять 10-30 секунд, если модель BGE-M3 необходимо загрузить (~150 МБ). Параметры: query (обязательный, 1..=8192 символов), limit (по умолчанию 5, макс. 50), semantic (по умолчанию false). |
forgeplan_fpf_section | Получает полное содержимое конкретного раздела FPF по ID (например, ‘B.3’, ‘C.2.2’, ‘A.1’). |
| Инструмент | Описание |
|---|
forgeplan_discover_complete | Завершает сессию исследования. Генерирует сводный отчёт с результатами по фазам/уровням, запускает forgeplan health и помечает сессию как завершённую. |
forgeplan_discover_finding | Сообщает об обнаруженном факте. Агент вызывает это после анализа файла/модуля/git-лога во время фазы. ForgePlan создаёт артефакт (note/prd/rfc/problem/evidence) с содержимым, помечает его уровнем источника и связывает с сессией исследования. |
forgeplan_discover_start | Запускает сессию исследования brownfield. Возвращает структурированный протокол (7 фаз: detect/structure/code/git/tests/docs/synthesize), которому следует ИИ-агент для составления карты существующей кодовой базы. ForgePlan предоставляет протокол; агент анализирует код и сообщает результаты через forgeplan_discover_finding. |