AI-пилот меняется быстро: источники обновляются, handoff rules уточняются, approval gates становятся строже. Decision Log сохраняет причину изменений, чтобы команда понимала, почему система ведёт себя именно так.

Простое определение

Decision Log — журнал решений по AI-ready проекту. Он фиксирует, какое решение принято, почему, из какого issue или source оно возникло, кто отвечает, нужно ли approval, когда решение проверено и что делать дальше.

Это не dashboard и не база данных. В public wiki-site Decision Log — reusable template, который показывает, как держать след решений в AI-пилоте.

Зачем он нужен

AI-пилот быстро меняется: Knowledge Pack обновляют, RAG Quality Report находит gaps, оператор просит новый handoff trigger, approval gate блокирует external action. Без Decision Log эти изменения остаются в переписке.

Decision Log нужен, чтобы команда могла ответить:

  • почему source поменяли;
  • кто подтвердил risky change;
  • какой issue закрыли;
  • какой сценарий нужно повторить;
  • готов ли pilot к следующему шагу.

Связь с RAG Quality Report

RAG Quality Report находит проблему: missing source, conflicting documents, outdated answer, risky overclaim, handoff required или pricing boundary.

Decision Log фиксирует решение по этой проблеме. Например: источник перевести в outdated, добавить forbidden claim, усилить handoff trigger или оставить действие за Approval Gate.

Связь с Approval Gates

Если решение влияет на внешнее действие — CRM write, email send, booking, payment, outbound call, publish — оно должно пройти Approval Gate. Decision Log хранит не только результат, но и причину: почему действие approved, rejected или needs_more_info.

Связь с Operator Handoff

Operator Handoff показывает, где агент остановился и какой context передал человеку. Decision Log помогает улучшать handoff: добавить missing field, изменить risk note, уточнить recommended next step или запретить неподтверждённое обещание.

Связь с Harness

Harness удерживает весь контур: sources, eval, handoff, approval, decision log и improvement loop. Decision Log — часть Harness, где каждое изменение проходит путь:

issue
→ decision
→ approval
→ fix
→ retest
→ reviewed

reviewed ставится только после повторной проверки. Если retest не проведён, status должен оставаться pending_retest, open или needs_more_info.

Связь с Pilot Review Packet

Pilot Review Packet использует Decision Log как объяснение итогового статуса. Если решение ещё open или pending_retest, packet обычно получает needs-fix. Если decision требует approval, но Approval Gate не пройден, packet не должен получать go.

Так Decision Log превращает review status в traceable decision: видно, какое issue найдено, почему принято решение, кто owner и какой retest нужен до следующего pilot review.

Минимальная строка

Каждая строка Decision Log должна иметь:

  • decision / решение;
  • reason / причина;
  • source_or_issue / источник или проблема;
  • owner / ответственный;
  • approval_required / нужно подтверждение;
  • status / статус;
  • reviewed_at / дата проверки;
  • next_action / следующее действие.

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

Используйте Decision Log после первого RAG Quality Report, перед pilot readiness review и каждый раз, когда меняется источник, answer policy, approval gate, handoff trigger или risk boundary.