forgeplan_drift

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

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

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

• Ежеквартальный аудит - поиск ADR, которые больше не соответствуют коду.
• Перед тем как объявить ADR авторитетным - убедитесь, что затронутые файлы не были переписаны.
• Перед рефакторингом - проверьте, регулируются ли ваши целевые файлы дрейфующим ADR, и сначала обновите его.
• Подготовка к релизу - убедитесь, что никакие архитектурные решения не являются незаметно просроченными.

Обнаружение дрейфа использует git mtime (или modified_at, записанный в LanceDB) для файлов, перечисленных в поле affected_files фронтматтера артефакта.

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

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

Возвращает

{
  "drifted": [
    {
      "id": "ADR-004",
      "kind": "adr",
      "created_at": "2026-02-15",
      "affected_files": [
        {
          "path": "crates/forgeplan-core/src/db/mod.rs",
          "modified_at": "2026-04-07",
          "days_since_decision": 51
        }
      ]
    }
  ],
  "total_drifted": 1
}

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

{}

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

1. forgeplan_drift - перечислить дрейфующие решения.
2. forgeplan_get каждый ADR - прочитать исходное обоснование.
3. Решите: всё ещё актуально? → forgeplan_renew. Больше не соответствует коду? → forgeplan_supersede с новым ADR.
4. forgeplan_drift снова - убедитесь, что список сократился.

Эквивалент CLI

forgeplan drift

См. также

• forgeplan_coverage - обратный вид: какие модули не имеют решений.
• forgeplan_stale - просроченность по времени (не по файлам).
• forgeplan_supersede - заменить дрейфующий ADR.
• Руководство по методологии