Multi-Layered PR Review Workflow

Multi-Layered PR Review Workflow A workflow diagram generated by Archify. 01 / PR Author / Developer 02 / L1: Deterministic CI Checks 03 / L2: Claude Code Review 04 / L3: Human Governance Gate Submission Automated Review Passes Sign-off & Landing Open Pull Request · commits & diff pushed · PR Author / Developer › Submission Open Pull Request commits & diff pushed Agent Fix Loop · @claude fix comments · PR Author / Developer › Automated Review Passes · auto-address Agent Fix Loop @claude fix comments auto-address L1 CI Pipeline · lint, types & test suite · L1: Deterministic CI Checks › Automated Review Passes · deterministic L1 CI Pipeline lint, types & test suite deterministic L2 Claude Review · REVIEW.md multi-pass · L2: Claude Code Review › Automated Review Passes · policy eval L2 Claude Review REVIEW.md multi-pass policy eval Machine-Readable Tally · severity & policy score · L2: Claude Code Review › Automated Review Passes Machine-Readable Tally severity & policy score L3 Code Owner Sign-off · branch protection gate · L3: Human Governance Gate › Sign-off & Landing · intent & risk L3 Code Owner Sign-off branch protection gate intent & risk Merge to Main · pipeline deployment · L3: Human Governance Gate › Sign-off & Landing · audit logged Merge to Main pipeline deployment audit logged approved green checks push commit severity threshold tag @claude categorize trigger CI Legend User UI Agent logic Policy Tool action Context / trace Cloud service

Separation of Duties

  • • Agent viết code tuyệt đối không có quyền tự approve PR
  • • Branch protection bắt buộc phê duyệt từ human Code Owner

REVIEW.md Policy Contract

  • • Phân tầng kiểm tra: Logic Bugs, Security và Spec Compliance
  • • Giới hạn Nits tối đa 5 điểm để tập trung vào Important risks