AI Tutor Platform - Documentation Index

Mục tiêu

• Tạo source-of-truth lane riêng cho AI Tutor, tách rõ khỏi Smart Search Layer 1.
• Chuẩn hóa logic AI Tutor như một lớp hướng dẫn học tập xuyên module.
• Đảm bảo docs đủ chi tiết để đi vào UX design + implementation contracts.

Trạng thái hiện tại

• Bộ tài liệu đã nâng từ scaffold sang active baseline theo DEC-0082..DEC-0092.
• Có thể dùng trực tiếp để triển khai UX logic và test acceptance.
• Nếu cần một góc nhìn cross-functional lớn hơn, có thể đối chiếu thêm với upstream synthesis doc kiểu DOL AI Coach System Spec; tuy nhiên folder này vẫn là implementation canon để chốt rule và contract thực thi.

Cấu trúc folder

• AIT_INDEX.md: cửa vào và lộ trình đọc chuẩn.
• AIT_00_Overview.md: định vị platform + principle baseline.
• AIT_Master_Product_Spec.md: spec tổng thể (contract-level).
• AIT_01_Conversation_Modes_and_Output_Contracts.md: mode matrix + output taxonomy.
• AIT_02_Exercise_Coaching_Integrity_Policy.md: policy không làm bài hộ khi active attempt.
• AIT_03_Smart_Search_Handoff_Contract.md: boundary + export context handshake.
• AIT_04_Runtime_and_Harness_Guidelines.md: runtime SSOT + internal harness rules + authoring checklist.
• AIT_Smart_Search_Carryover_Notes.md: carryover từ Smart Search và delta cần giữ.
• AIT_Doc_Landscape.md: bản đồ docs liên quan + gap tracking.
• AIT_Playground_Implementation_Status.md: bridge note ngắn giữa canon docs và những gì Playground DOL English đã thực sự dựng được.

Đọc nhanh đề xuất

1. AIT_00_Overview.md
2. AIT_Master_Product_Spec.md
3. AIT_01_Conversation_Modes_and_Output_Contracts.md
4. AIT_02_Exercise_Coaching_Integrity_Policy.md
5. AIT_03_Smart_Search_Handoff_Contract.md
6. AIT_04_Runtime_and_Harness_Guidelines.md
7. AIT_Smart_Search_Carryover_Notes.md
8. AIT_Doc_Landscape.md
9. AIT_Playground_Implementation_Status.md

Boundary với Smart Search

• Smart Search / AI Inline: Layer 1, insight nhanh + action ngắn.
• AI Tutor: Layer 2, hội thoại đào sâu và hướng dẫn học tập.
• AI Tutor giữ rule on-demand only, không auto-open.

Canonical Decisions

• DEC-0082: role + capability baseline.
• DEC-0083: grounded knowledge + recommendation contract.
• DEC-0084: exercise coaching integrity (no final answer in active attempt).
• DEC-0085: output artifact taxonomy + progress insight policy.
• DEC-0086: Smart Search AI Inline boundary.
• DEC-0087: inline -> tutor export-context handshake.
• DEC-0088: mobile payload compression policy for inline -> tutor handoff.
• DEC-0089: AI Thi thu Full Test mapping (ACT_TEST + AIF_MOCK_FULL_TEST variant).
• DEC-0090: diagram/mindmap layered rendering fallback policy.
• DEC-0091: provenance visibility depth by segment.
• DEC-0092: sandbox exception boundary for non-graded practice.

Change log

• 2026-03-26: Bổ sung AIT_Playground_Implementation_Status.md như bridge note để đọc nhanh canon docs -> Playground runtime -> current gaps.
• 2026-03-21: Bổ sung note phân biệt upstream synthesis vision với implementation canon để giảm drift khi đối chiếu tài liệu ngoài lane source-of-truth.
• 2026-03-01: Wave 2 closure bổ sung DEC-0088..DEC-0092 và nâng baseline lên no-blocker state cho AI Tutor core logic.
• 2026-03-14: Bổ sung doc AIT_04_Runtime_and_Harness_Guidelines.md để khóa runtime order, harness boundary, và authoring checklist cho lane AI Tutor.
• 2026-03-01: Nâng index lên active baseline, bổ sung docs chi tiết mode/coaching/handoff.
• 2026-02-28: Tạo folder AI Tutor Platform và khung sườn ban đầu để tách luồng tài liệu khỏi Smart Search Platform.