Ra quyết định đúng độ sâu và giữ rationale

Architecture là chuỗi trade-off dưới constraints; ADR ghi context và lý do, không đóng băng tương lai.

Decision frame

Problem, decision drivers, constraints/non-goals, options, consequences và evidence. Phân biệt reversible two-way door với costly one-way door để chọn tốc độ và review depth.

Options

Giữ status quo như một option; so sánh bằng workload/failure/security/cost/operability thay vì popularity. Prototype rủi ro lớn nhất, không làm demo happy path.

Participation

Xác định decision owner, consulted experts và deadline. Seek dissent, pre-mortem và written feedback; disagree-and-commit sau khi concern đã được xử lý minh bạch.

ADR lifecycle

Accepted, superseded/deprecated; liên kết implementation và verification. Review khi assumptions/constraints đổi, tránh sửa lịch sử để giả vờ quyết định cũ chưa tồn tại.

Architecture Decision Records · Documenting Architecture Decisions
← FlowReview →