forgeplan context

forgeplan context возвращает всё, что нужно AI-агенту для рассуждений об артефакте за один вызов: тело артефакта, его родительские/дочерние связи, результаты валидации, оценку R_eff и связанную память. Вместо пяти обращений (get, validate, score, graph, memory), агент запрашивает один раз и получает полную картину.

Это основная точка доступа к данным для сервера Forgeplan MCP - каждый вызов инструмента forgeplan_context проходит через эту команду. Использование CLI в основном предназначено для отладки того, что фактически видит агент.

Когда использовать

AI-агенту (через MCP) требуется полное состояние артефакта перед редактированием или рассуждением
Отладка того, какой контекст передаётся в forgeplan reason или forgeplan generate
Написание внешнего скрипта, который анализирует состояние и связи артефакта
Проверка, достаточно ли связанных доказательств у артефакта, чтобы быть надёжным
Подготовка входных данных для ручного ревью - единый вывод охватывает всё

Когда НЕ использовать

Вам нужно только тело артефакта - используйте forgeplan get <ID> (более лёгкая полезная нагрузка)
Вам нужны только результаты валидации - используйте forgeplan validate <ID>
Вам нужна только оценка - используйте forgeplan score <ID>
Вы отображаете панель мониторинга для человека - используйте forgeplan health или forgeplan status

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

forgeplan context [OPTIONS] <ID>

Аргументы

  <ID>  ID артефакта (PRD, RFC, ADR, Epic, Problem, ...)

Опции

      --json     Вывод в формате JSON для машинной обработки (основной режим для AI-агентов)
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Пример 1: Полный контекст для PRD

forgeplan context PRD-001

Выводит тело PRD, вердикт валидации, оценку R_eff, восходящие/нисходящие связи и любые связанные примечания. По умолчанию выводятся в человекочитаемом формате Markdown.

Пример 2: Полезная нагрузка JSON для агента или скрипта

forgeplan context PRD-001 --json

Выводит структурированный JSON с ключами верхнего уровня:

{
  "artifact": { "id": "PRD-001", "kind": "prd", "status": "active", "body": "..." },
  "validation": { "verdict": "PASS", "must": [], "should": [] },
  "scoring": { "r_eff": 0.82, "evidence_count": 4 },
  "graph": {
    "parents": [{ "id": "EPIC-002", "relation": "child_of" }],
    "children": [{ "id": "RFC-018", "relation": "implements" }],
    "evidence": [{ "id": "EVID-042", "verdict": "supports" }]
  },
  "memory": [{ "key": "decision", "value": "..." }]
}

Пример 3: Отладка поведения агента MCP

forgeplan context PRD-019 --json | jq '.graph.evidence'

Если агент утверждает «нет связанных доказательств», но вы не согласны, запустите это, чтобы точно увидеть, что возвращает уровень MCP.

Интерпретация вывода

Полезная нагрузка JSON состоит из пяти разделов; каждый из них необязателен, если пуст:

artifact - frontmatter + тело markdown точно так, как хранится на диске
validation - verdict имеет значение PASS или FAIL; must и should перечисляют нарушения правил
scoring - r_eff - это оценка доказательств по принципу «слабого звена» (0.0-1.0); evidence_count - это количество связанных EvidencePack
graph - массивы parents, children, evidence с ID и типом связи
memory - записи памяти решений, относящиеся к этому артефакту

Красные флаги:

r_eff: 0.0 и evidence_count: 0 для активного артефакта - слепое пятно, создайте доказательство
validation.verdict: "FAIL" для активного артефакта - такого никогда не должно быть, показывает расхождение при приёме данных
Пустой graph.parents для PRD, который должен реализовывать Epic - отсутствует связь

Как это вписывается в рабочий процесс

Shape → Validate → Reason → Code → Evidence → Activate
                    ^                   ^
                context feeds here   context used in audits

Вызывается автоматически forgeplan reason, forgeplan generate и инструментами MCP
Используйте вручную для предварительного просмотра того, что увидит агент, прежде чем запускать рассуждения
Используйте в паре с forgeplan audit для массовых проверок контекста по множеству артефактов

См. также

forgeplan get - более лёгкое подмножество (только артефакт)
forgeplan validate - подмножество валидации
forgeplan score - подмножество скоринга
forgeplan reason - использует контекст для анализа ADI
forgeplan health - панель мониторинга по всему проекту