forgeplan_graph

Генерирует Mermaid graph TD для всех связанных артефактов в рабочем пространстве. Включает явные типизированные связи (based_on, refines, supersedes, contradicts, informs), а также неявные рёбра belongs_to из поля parent_epic во фронтматтере.

Категория: Панели мониторинга и графы

Когда агент вызывает его

• Визуализация архитектуры - показать, как связаны цепочки PRD → RFC → ADR → Evidence.
• Анализ влияния - отслеживать, какие нижестоящие артефакты зависят от узла, прежде чем заместить его.
• Генерация документации - встроить диаграмму в README или на страницу веб-сайта.
• Подготовка к ревью - визуально проверять циклы или отсутствующие рёбра перед релизом.

Выходные данные представляют собой чистый Markdown Mermaid - отобразите их в любом средстве просмотра Markdown, поддерживающем Mermaid (GitHub, Starlight, предварительный просмотр VS Code и т. д.).

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

Входные параметры отсутствуют. Вызовите этот инструмент с пустым объектом {}.

Возвращает

{
  "mermaid": "graph TD\n  EPIC-003[EPIC-003] --> PRD-035[PRD-035]\n  EPIC-003 --> PRD-039[PRD-039]\n  PRD-039 --> RFC-006[RFC-006]\n  RFC-006 --> ADR-004[ADR-004]\n  EVID-052[EVID-052] -.informs.-> PRD-039\n",
  "node_count": 184,
  "edge_count": 312
}

Стили рёбер:

• Сплошная (-->) - структурные (based_on, refines, parent_epic).
• Пунктирная (-.->) - информационные (informs, weakens, supports).
• Красная (==>) - contradicts.

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

{}

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

1. forgeplan_graph - получить mermaid.
2. Отобразить его или сохранить в docs/graph.md.
3. forgeplan_order - получить топологическую сортировку для того же графа.
4. forgeplan_blocked - найти узлы, заблокированные невыполненными предварительными условиями.

Эквивалент CLI

forgeplan graph

См. также

• forgeplan_order - топологическая сортировка графа.
• forgeplan_blocked - артефакты, заблокированные зависимостями.
• forgeplan_link - добавить новое ребро.
• Руководство по методологии