forgeplan_validate

Запускает валидатор на основе правил для артефакта. Каждый тип (PRD, RFC, ADR, Epic, Spec) имеет набор правил, учитывающих глубину (более 30 правил), который проверяет обязательные разделы, поля frontmatter, плотность и перекрёстные ссылки. Сбои типа MUST блокируют forgeplan_activate. Это основной гейт качества агента перед объявлением артефакта «готовым».

Категория: Качество и валидация

Когда агент вызывает эту функцию

Сразу после заполнения заглушки - «покрыл ли я всё, что требуется шаблоном?»
В цикле с forgeplan_update: валидировать → исправить результат → валидировать → повторять до статуса PASS.
Проверка перед активацией: если остаются какие-либо MUST-сбои, forgeplan_activate всё равно завершится неудачей, поэтому сначала выполните валидацию.

Входные параметры

Имя	Тип	Обязательный	Описание
`id`	`string`	no	ID артефакта для валидации. Валидирует все артефакты, если пропущен.

Источник схемы: crates/forgeplan-mcp/src/server.rs::ValidateParams

Возвращает

Вердикт плюс список результатов. Каждый результат содержит severity (MUST / SHOULD / COULD), rule_id, message и часто указатель section. status: PASS означает отсутствие MUST-сбоев - агент может активировать.

Пример структуры ответа:

{
  "id": "PRD-042",
  "status": "FAIL",
  "must_count": 1,
  "should_count": 2,
  "findings": [
    { "severity": "MUST", "rule": "prd.has_problem", "message": "Missing ## Problem section" },
    { "severity": "SHOULD", "rule": "prd.density", "message": "Problem section < 50 words" }
  ]
}

Пример вызова

{ "id": "PRD-001" }

В типичном контексте агента:

Агент только что создал PRD-001 и хочет выполнить валидацию перед активацией.

{ "id": "PRD-001" }

Типичная последовательность

forgeplan_update → forgeplan_validate → (если есть MUST-сбои) forgeplan_update исправление → forgeplan_validate снова → PASS → forgeplan_activate. Этот же инструмент также полезен в цикле устранения проблем forgeplan_health при очистке слепых пятен.

Эквивалент CLI

forgeplan validate - те же правила, вывод в терминал

См. также

Обзор MCP
forgeplan_activate - гейт, соблюдение которого обеспечивает валидация
forgeplan_score - ортогональный сигнал качества (R_eff)
forgeplan_review - удобочитаемый отчёт о готовности