Idea Flow Lite Guide

Purpose

• Idea Flow Lite là model reminder-first cho concept docs.
• Nó không phải full spec.
• Mục tiêu là nhắc AI và contributor những flow anchors quan trọng nhất để không quên, không nhầm, nhưng vẫn giữ không gian sáng tạo.
• Nó là lane phụ để capture concept UI hoặc idea delta, không phải lane chính để xây logic UX canon.

Core Rules

• One screen, one file.
• Dùng canonical concept filename: <SCREEN_ID>_<screen_name_slug>_UI_CONCEPT.md.
• Keep only the minimum flow anchors.
• Coherence over completeness.
• Mỗi file phải đủ gọn để đọc nhanh trên wiki.
• Chỉ giữ source notes thật sự cần để truy vết.
• Relevant states only; không ép đủ loading/empty/error/success nếu screen không cần.
• Hard gates chỉ dùng để chặn lỗi logic/risk nặng, không dùng để ép AI thành full spec.

UX-first Parallel Rule

• Nếu user đã nêu feature, flow, screen, hoặc update cụ thể, build/update docs/Domains/<domain>/UX Design/** trước.
• Nếu task ở cấp feature hoặc cross-surface và domain đã có feature-master active, mở file đó trước để lấy current truth rồi mới xuống screen/concept docs.
• Product Discovery là lớp sync-back nhanh cho rationale, decision, contract, hoặc extraction map; có thể làm cùng vòng hoặc ngay sau vòng UX chính.
• Chỉ dùng Idea Flow Lite khi task thực sự cần concept artifact hoặc cần ghi lại idea mới trong lúc build UX docs.
• Khi đã chạm một feature active, agent nên tự rà nhanh các góc entry, state, ownership, cross-surface impact, và open validation; nếu thấy gap non-blocking thì để lại follow-up note ngắn.
• Runtime shortcut: nếu manifest đã có screen_list_output, bắt đầu từ concept -> qa; nếu mới có inventory_file, bắt đầu từ screen_audit -> concept -> qa; chỉ chạy full flow khi chưa có reusable UX artifact đủ tốt.
• Chỉ hỏi user đúng 1 câu ngắn khi ambiguity còn đủ lớn để tạo ra 2 branch UX khác nhau và current canon không cho safe default.
• Không bắt agent hoàn tất một vòng discovery đầy đủ trước khi viết UX Design.
• Idea Flow Lite không giữ feature-level current truth; nếu concept chạm rule cấp feature, sync-back về feature-master hoặc supporting rule doc của feature đó.

Standard Sections

• Global Context
• Flow Snapshot
• Core Reminders
• Experience Direction
• Key Elements & States
• AI Creative Cue
• Open Questions
• Source Notes

Writing Guidance

• Global Context: 3-4 bullets là đủ.
• Flow Snapshot: nói rõ user moment, entry, exit, primary CTA direction.
• Core Reminders: chỉ ghi những thứ AI rất dễ quên hoặc rất dễ làm sai.
• Experience Direction: nói cảm giác, nhịp, ưu tiên thị giác, không khóa layout thành checklist cứng.
• Key Elements & States: nêu phần tử chính và các state thực sự ảnh hưởng quyết định tiếp theo của user.
• AI Creative Cue: một cue ngắn để AI tự phát huy, không cần prompt pack dài.
• Source Notes: Fact và Constraint ngắn với citation.
• Product Discovery sync-back note nếu cần chỉ nên gói trong tối đa 3 bullets: decision/assumption, rationale, impacted UX docs.
• Open Questions: chỉ giữ các điểm còn mở nhưng không làm đổi branch UX chính; nếu còn làm đổi branch UX chính và current canon không cho safe default thì hỏi user một lần rồi đi tiếp.
• Mỗi section nên là bullet list ngắn; không để prose rơi tự do hay appendix legacy lẫn vào contract Lite.

What To Avoid

• Không biến file thành implementation spec.
• Không biến idea-flow thành lane chính để author feature logic.
• Không biến concept file thành canonical feature overview hoặc feature rule owner.
• Không lặp cùng một ý qua nhiều section.
• Không thêm rule pixel/hex nếu source không bắt buộc.
• Không kéo vào các fact xa screen hiện tại.
• Không dùng boilerplate kiểu prompt dump.

Migration Note

• Legacy concept files vẫn có thể tồn tại trong giai đoạn chuyển tiếp.
• Từ bây giờ, concept mới nên theo contract nhẹ này.
• Khi update file cũ, ưu tiên rút gọn về format trên thay vì bồi thêm section mới.
• Nếu hard gates đã pass nhưng tài liệu vẫn có thể hay hơn, xử lý như improvement note thay vì blocker.