Account - Documentation Guidelines for AI (Cross-domain)

Purpose

• Chuẩn hóa cách AI viết/cập nhật tài liệu Account theo DOL English, DOL Academy, DOL Kid.
• Giữ tài liệu ngắn, dễ hiểu, ưu tiên quyết định UX.

Writing Direction

• UX-first: nói rõ user thấy gì, ai làm gì, bước tiếp theo là gì.
• Core + Delta: phần dùng chung viết một lần; domain chỉ ghi phần khác biệt.
• Lean docs: nếu nội dung không giúp chốt quyết định UX, không cần giữ dài.
• Role clarity: luôn làm rõ ai đang quản lý account trong flow.

Canonical Sources

1. ACC_Identity_UX_Blueprint.md
2. ACC_Domain_Coverage_Matrix.md
3. ACC_KID_Guardian_Managed_Overlay.md
4. ACC_00_Overview.md
5. ACC_Logic.md
6. ACC_Screens_Flow.md

Target File Roles

• ACC_Identity_UX_Blueprint.md = core_canon
• ACC_Domain_Coverage_Matrix.md = core_canon
• ACC_KID_Guardian_Managed_Overlay.md = domain_overlay
• ACC_Logic.md = baseline_active_local của DOL English Web V2
• ACC_Screens_Flow.md = baseline_active_local của DOL English Web V2

Required Structure for New Docs

• Purpose
• When to use
• Main flow
• Domain delta
• Edge cases
• References
• Change log

Anti-drift Rules

• Không dùng ACC_Logic.md của DOL English như canon chung cho mọi domain.
• Không nhét logic parent/child vào baseline English nếu đó là KID-only.
• Không mô tả KID như một account hoàn toàn tách rời nếu vẫn yêu cầu continuity sang English/Academy.
• Nếu flow làm rõ thêm continuity, cập nhật cả blueprint và matrix.
• Nếu behavior là KID-only:
  • patch chính vào ACC_KID_Guardian_Managed_Overlay.md,
  • chỉ cập nhật ACC_Logic.md hoặc ACC_Screens_Flow.md khi cần giữ boundary note hoặc pointer.
• Không mô tả flow guardian-managed chi tiết bên trong file đang có Scope Gate là single-user account.

Domain Acceptance Contract

• Continuity:
  • account học của user phải đi tiếp được qua các stage học.
• Guardian-managed clarity:
  • nếu là KID, phải nói rõ phụ huynh quản lý gì và trẻ làm gì.
• Domain boundary:
  • lane phụ huynh chỉ có ở KID.
• No reset account:
  • khi mở lane self-managed về sau, không tạo lại account mới nếu không có lý do đặc biệt.
• Cross-area routing:
  • nếu flow nói về phụ huynh tạo account cho con, ưu tiên Account là area chính,
  • nếu flow nói về nhập code để vào học, giữ Account là canon về identity nhưng coi Register/Auth là area phụ để mô tả entry UX.

Creativity-safe Rules

• Được đề xuất UX mới nếu:
  • giúp flow đơn giản hơn,
  • làm rõ vai trò hơn,
  • không phá continuity của account.

Iterative Loop

1. Analyze: đọc overview + blueprint + matrix.
2. Classify: xác định file sắp sửa là core_canon, domain_overlay, hay baseline_active_local.
3. Draft: viết ngắn, rõ vai trò và continuity.
4. Check: so lại boundary giữa English và KID.
5. Adjust: bỏ đoạn kỹ thuật hoặc trùng lặp.
6. Finalize: cập nhật references + changelog.

Reusable Prompt Snippet

• Hãy viết tài liệu Account theo Core + Domain Delta, ưu tiên continuity của danh tính người học, và giữ rõ boundary giữa self-managed account với guardian-managed account.

Change log

• 2026-03-06: Tạo guideline AI cho Account cross-domain theo hướng UX-first, lean và role-based.