Trigger Checklist - Core + Conditional (UX Docs v2)

Purpose

• Chuẩn hoá cơ chế “chỉ thêm thông tin khi thật sự cần thiết”.
• Giảm overdocumentation nhưng vẫn đủ decision context cho team triển khai.

Core Sections (vary by doc_role)

Sections required depend on doc_role - see rule-doc-standards.md §2 profile table. For page-spec (default UX doc), all 6 are required:

• Purpose
• Experience Narrative (Ý tưởng tổng quan)
• Elements hoặc Elements / Scope
• Logic hoặc Logic / Rules
• UI / Behavior
• Change log

Conditional Sections (trigger-based)

• Scope / Non-goals
  • Trigger: phạm vi dễ bị hiểu sai hoặc có rủi ro scope creep.
• Roles / Actors
  • Trigger: có từ 2 role trở lên với quyền/trải nghiệm khác nhau.
• Dependencies / Integration
  • Trigger: có phụ thuộc module khác hoặc luồng liên miền.
• State model / Edge cases
  • Trigger: có state transition, fallback, error branch.
• Metrics / Analytics
  • Trigger: cần đo outcome hoặc có event mới.
• Data model / API touchpoints
  • Trigger: có thay đổi entity/field/contract.
• Open questions / Decisions
  • Trigger: còn quyết định mở hoặc trade-off chưa chốt.
• References
  • Trigger: có tài liệu/phần phụ trợ bắt buộc để implement.

Need Gate Rules

• Không tạo section mở rộng nếu trigger không thỏa.
• Không để placeholder (TBD, sẽ cập nhật, section rỗng).
• Không ghi giả định tương lai nếu chưa có quyết định.
• Nếu không cần, xoá section thay vì giữ khung.

Quick QA

• Required sections cho doc_role này đầy đủ?
• Purpose có 3 ý: vấn đề, đối tượng, tín hiệu thành công?
• Mỗi section mở rộng đều có trigger tương ứng?
• Change log đúng format YYYY-MM-DD: ...?
• Không có section rỗng/placeholder?