GPT REVIEW — Reset về yêu cầu gốc / Sửa rẻ Nhập UI v0

Ngày: 2026-07-06
Mục tiêu: rà soát Rev 6 theo yêu cầu gốc của Owner: Cowork thiết kế UI → túi thuốc/companion liệt kê khái niệm tại chỗ → so với danh sách khái niệm nháp để chống double.
Trạng thái: REVIEW, chưa execution. Không DDL/DML.

1. Yêu cầu gốc, viết lại cho đúng

Yêu cầu thật chỉ có 3 việc:

1. Cowork cứ thiết kế UI.
2. Mỗi UI có một “túi thuốc”/companion gắn kèm, liệt kê các đầu mối/khái niệm dùng ngay tại UI.
3. Hệ so companion đó với danh sách khái niệm nháp tổng hợp để biết: dùng khái niệm cũ, cần tạo khái niệm mới, hay đang trùng/double.

Mục tiêu cốt lõi: chống double khái niệm, không phải xây metadata system mới.

2. Rev 6 có đi xa quá không?

Có nguy cơ đi xa ở cách trình bày và số gate, nhưng chưa đi sai về lõi. Phần lớn thứ thêm vào là guardrail vận hành, không phải chức năng mới.

Điểm cần sửa là phải đưa mặt tiền kế hoạch về 3 món gốc, còn các phần như no-vector, rollback, Path A/B, pre-flight chỉ để ở tầng hạ tầng/appendix.

3. Ba tầng nên tách rõ

Tầng 1 — Mission, bắt buộc đọc trước

• UI file.
• Companion .scan.json cạnh UI.
• Danh sách khái niệm nháp tổng hợp.
• So sánh để chống double.

Tầng 2 — Cơ chế tối thiểu

• 2 bảng PG nháp: concept catalog + UI usage.
• Import companion.
• View/SELECT so cũ-mới.
• Owner quyết: map_existing / create_new / keep_pending.

Tầng 3 — Hàng rào an toàn, không phải mission

• No-vector policy.
• Rollback.
• Directus collection/report.
• Pre-flight gates.
• Path A/B.
• Coverage audit.

Nếu người đọc nhảy thẳng vào tầng 3 sẽ tưởng hệ rất phức tạp. Cần sắp xếp lại tài liệu để tầng 1 luôn đứng trước.

4. Cái nên giữ

1. Companion cạnh UI.
2. Definition of Done: thiếu companion hợp lệ = UI chưa xong.
3. 2 bảng PG nháp.
4. Cowork chỉ khai thô, không tự match.
5. Purpose bắt buộc.
6. PG/view so với khái niệm nháp tổng hợp.
7. Owner quyết 3 action.
8. No-vector nếu tạo collection.
9. G1b: thử Cowork xuất companion thật trước khi report/UI.

5. Cái nên hạ tầng/defer, không để làm người đọc tưởng đó là nhiệm vụ chính

1. Path A/B: chỉ là lựa chọn hạ tầng, không phải logic sửa-rẻ.
2. Report /reports/report-sua-re: G2, chỉ sau khi G1b pass.
3. Coverage filesystem: audit hỗ trợ, không phải dashboard/report v0.
4. Vector policy: bắt buộc nếu tạo collection, nhưng là hàng rào an toàn, không phải tính năng.
5. Canonical JSON / item_key / pending dedupe: chi tiết cổng import, không để Cowork thấy.
6. Pre-flight gates: chỉ dành cho Claude Code, không đặt như luồng nghiệp vụ.

6. Cái cần cắt nếu xuất hiện

• Parser/OCR/DOM scan.
• DOT đọc lại UI để đếm.
• Qdrant/pg_trgm/fuzzy auto-match.
• Bảng scan riêng, bảng history riêng, bảng alias riêng.
• Decision-DOT ở v0.
• UI/tab/report đẹp trước G1b.
• Species mới.
• Ép Path A nếu phải vá nhiều lớp.

7. Đề xuất patch tài liệu

Không cần đổi nội dung kỹ thuật lớn. Chỉ cần thêm đầu tài liệu một mục “ONE-PAGE SIMPLE FLOW” để neo lại yêu cầu gốc:

ONE-PAGE SIMPLE FLOW
1. Cowork tạo/sửa UI.
2. Cowork copy túi thuốc .scan.json cạnh UI và khai tối thiểu: raw_label + purpose.
3. Import companion vào PG.
4. PG so với danh sách khái niệm nháp tổng hợp.
5. Kết quả chỉ có 3 loại: matched / review / candidate.
6. Owner quyết: map_existing / create_new / keep_pending.
7. Mục tiêu: chống double khái niệm. Hết.

Sau đó ghi rõ:

Các mục Path A/B, no-vector, rollback, report, pre-flight là hàng rào hạ tầng; không làm thay đổi yêu cầu nghiệp vụ trên.

8. Verdict

Rev 6 chưa sai, nhưng cần đổi cách trình bày để không dẫn agent vào bụi rậm. Mặt tiền của kế hoạch phải quay về đúng 3 việc gốc. Toàn bộ hạ tầng chỉ phục vụ 3 việc đó.