3-layer review і людські контрольні точки

Три шари review і контрольні точки

Паралельним агентам потрібні межі автономності. Типовий workflow виглядає так: план → зміни → local review → CI та quality gates → людське схвалення → merge або release.

Контрольна точка визначає, хто ухвалює рішення, а quality gate — які технічні умови має пройти зміна.

Layer 1 — локальний контроль

1. Затвердьте план і межі треку.
2. Перевірте, що агент не вийшов за scope.
3. Перегляньте diff.
4. Запустіть targeted local checks.
5. За потреби залучіть reviewer-agent для scope creep і missing tests.

Layer 2 — технічні gates

• тести зачепленого модуля;
• build, lint і typecheck;
• smoke та regression checks;
• сканування секретів;
• перевірка опису ризиків.
• AI-review доповнює CI, але не замінює детерміновані перевірки.

Layer 3 — людське рішення

Явного схвалення людини потребують merge, deploy, зміни конфігурації або секретів, деструктивні операції, записи у зовнішні системи й зміни в чутливих зонах на кшталт payments, pricing або спільного конфігу.

Для кожної критичної області призначте конкретного owner. Розмите «хтось із команди» створює колективну безвідповідальність.

CHECKPOINTS.md і журнал стану

track: promo
plan_approved: yes
diff_reviewed: yes
ci: passed
layer_3_blocker: human approval required
merge_order: after checkout contract