Review lộ trình và trang tiến độ dạy học

Đã xảy ra gì

• Review toàn bộ 16 file giai đoạn, plan.md, docs/roadmap.md và docs/tech-stack.md. Báo cáo: plans/reports/review-261013-1855-roadmap-learning-flow-and-gaps.md. Báo cáo liệt kê năm lỗi (RV1–RV5), mười chỗ văn bản đã lỗi thời (RV6), hai đề xuất về thứ tự học (RV7, RV8) và một lỗ hổng của harness, đó là thiếu vòng đánh giá (RV9).
• Xây plans/260922-0123-hango-agent-harness-roadmap/plan.html. Trang này gồm harness là gì, agent loop, run bền vững, middleware, observability, tenancy, kiến trúc theo từng giai đoạn, bậc thang lộ trình và các phát hiện từ review.
• build_plan_html.go (//go:build ignore, chỉ dùng stdlib) sinh trang này từ plan-template.html, các file giai đoạn, báo cáo review mới nhất và bốn sơ đồ đã biên dịch trong diagrams/.
• Tiến độ lấy từ 186 ô checkbox tiêu chí thành công, dùng cùng quy tắc với ak plan parse.
• Danh sách bàn giao trong docs/roadmap.md §5 giờ có thêm việc tick các tiêu chí và tạo lại plan.html.
• Đã publish một bản riêng tư: hango harness plan.

Vấn đề gặp phải

• Bài học của giai đoạn 1 bị bỏ sót vì một chú thích trong ngoặc nằm giữa các đường dẫn đặt trong dấu backtick làm bộ phân tích đường dẫn dừng lại. Đã sửa leadPathRe để bỏ qua các chú thích (...) và so sánh các đường dẫn trích ra trước và sau thay đổi.
• Trình biên dịch sơ đồ âm thầm không tạo ra gì khi được gọi qua đường dẫn skill là symlink. Gọi qua realpath thì chạy được.
• Chrome headless trên macOS ép chiều rộng cửa sổ về 500px và đi theo theme của hệ điều hành.
  • Việc kiểm tra trên điện thoại giờ chạy trong một iframe 375px, iframe này gửi báo cáo bố cục lên trang cha.
  • Theme được ép bằng --blink-settings=preferredColorScheme.
• Ảnh chụp màn hình sau scrollTo ra trắng, nên các mục được dịch vị trí bằng margin-top âm thay vì cuộn.
  • Ở 375px và 768px, các bảng rộng bị cuộn ngang và che mất cột (cột trạng thái của bảng cấu tạo, các mô tả hook).
  • Từ 700px trở xuống, các bảng có từ ba cột trở lên giờ xếp chồng thành các thẻ có nhãn.
  • min-width của table.wide được cắt còn 640px.
• Các trình xem artifact đặt data-theme trên phần tử gốc.
  • Các token tối giờ được bảo vệ bằng :root:not([data-theme="light"]), kèm một bản sao dưới :root[data-theme="dark"].
  • Việc đồng bộ theme của sơ đồ đi theo thuộc tính của phần tử gốc.

Quyết định

• Các checkbox của giai đoạn là nguồn duy nhất của tiến độ. Không có file trạng thái riêng.
• Trang không cần truy cập mạng. Các URL bên ngoài chỉ là liên kết đi ra.
• Chế độ xem kiến trúc hiển thị v1 cho tới khi một giai đoạn xong. Sau đó nó bắt đầu từ giai đoạn cuối của chuỗi liền mạch các giai đoạn đã xong.

Bước tiếp theo

• Người dùng quyết định áp dụng mục nào trong RV1–RV9 (RV1: O1 hoặc O2; RV9: O1, O2 hoặc O3) và có xây theo thứ tự 1 → 3 → 2 → 4 → 5 hay không.
• Sau đó /ak:cook giai đoạn 1.
• Sau mỗi giai đoạn:
  • Tick các tiêu chí và chạy go run build_plan_html.go.
  • Nếu các ô được tick bằng tay, chạy ak plan reindex --apply.
  • Publish lại bản chia sẻ.

Bản ghi công việc lịch sử, không phải căn cứ lâu dài. Hãy ưu tiên docs/specs/ADR cho các quyết định hiện hành.