forgeplan_coverage

Показать покрытие архитектурных решений по всей кодовой базе. Для каждого модуля кода (крейт / директория / пакет верхнего уровня) инструмент сообщает, сколько артефактов ADR / RFC / PRD ссылаются на него через affected_files, и выделяет модули с нулевым количеством решений - «слепые пятна решений», где код не задокументирован с архитектурной точки зрения.

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

Когда агент вызывает инструмент

• Архитектурный аудит - найти модули, для которых никто никогда не писал ADR.
• Онбординг - новые инженеры могут быстро найти задокументированные части системы.
• Перед рефакторингом - убедиться, что модуль, который вы собираетесь изменить, имеет (или нуждается в) ADR.
• Готовность к релизу - ни один высоконагруженный модуль не должен иметь нулевое количество решений.

Покрытие является дополнением к forgeplan_drift: drift говорит: «решения существуют, но код изменился», а покрытие говорит: «код существует, но решение никогда не было зафиксировано».

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

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

Возвращает

{
  "modules": [
    {
      "path": "crates/forgeplan-core/src/scoring",
      "decisions": ["ADR-002", "RFC-004"],
      "count": 2
    },
    {
      "path": "crates/forgeplan-core/src/projection",
      "decisions": [],
      "count": 0,
      "blind_spot": true
    }
  ],
  "total_modules": 18,
  "covered": 12,
  "blind_spots": 6
}

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

{}

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

1. forgeplan_coverage - перечислить модули со слепыми пятнами.
2. Для каждого: определить, заслуживает ли он ADR (нетривиальные дизайнерские решения).
3. forgeplan_new adr → задокументировать решение.
4. forgeplan_link → прикрепить к затронутым файлам.
5. forgeplan_coverage снова - подтвердить устранение слепого пятна.

Эквивалент CLI

forgeplan coverage

См. также

• forgeplan_drift - решения, чьи файлы изменились.
• forgeplan_blindspots - слепые пятна на уровне артефактов (нет доказательств).
• forgeplan_new - создать новый ADR.
• Руководство по методологии