M-001 Comment Module — Lịch sử Thảo luận
Thảo luận Comment Module — Lịch sử Quyết định
Module: M-001 | Participants: User (Huyen), Claude AI, Gemini, Claude Code Cập nhật: 2026-03-03
Timeline Quyết định
S86–S87: Nền tảng Module Protocol
Bối cảnh: Cần chuẩn hóa cách xây module để mọi AI/Agent hiểu nhất quán.
Quyết định:
- Tạo Module Protocol Standard (SSOT) — định nghĩa props/events/slots cho mọi module
- M-001 (CommentModule) là module đầu tiên áp dụng chuẩn này
- Test: Claude AI comment qua MCP, System checkpoint auto-tick simulation → đều hoạt động
Evidence: comment-142 (Claude AI MCP test), comment-149 (System checkpoint auto-tick)
S88E: v1 Implementation
Bối cảnh: Claude Code CLI triển khai v1 CommentModule.
Đã xây:
- CommentModule.vue — component chính, mount bằng
<CommentModule :task-id="X" /> - useComments.ts — composable CRUD comments
- 8 tab scopes: planning, checklist, test, reports, verify, prompt, rules, general
- Agent badges: hiển thị ai comment (claude_code, gemini, gpt, system, user)
- Markdown rendering
Kết quả: v1 DONE ✅ — PR #398
S96: Chốt hướng v2 + M-002
Bối cảnh: User đặt vấn đề: cần workflow visual + checkpoint tự động. Gemini đề xuất BPMN.
Thảo luận chính:
-
Checkpoint 3 tầng: User yêu cầu con người KHÔNG làm tester → cần hệ thống tự verify.
- L0 (System): CI/test/build auto-check
- L1 (AI): Critic review, enforcement qua prompt (Phương án C)
- L2 (User): Chỉ approve exceptions
-
Liên thông M-001 ↔ M-002: Comment trong M-001 trigger thay đổi workflow trong M-002. VD: AI ghi chú "thêm bước review" → M-002 cập nhật BPMN diagram.
-
L1 Enforcement: 3 phương án thảo luận:
- A: Code cứng (strict validation) → quá rigid
- B: Directus Flow trigger → phức tạp
- C: AI tự tạo, enforcement qua prompt → ✅ CHỐT. Đơn giản, linh hoạt, phù hợp Assembly First.
Quyết định S96:
- bpmn-js: ✅ PHÊ DUYỆT cho M-002
- Code mới (500+ dòng): ✅ PHÊ DUYỆT
- L1 Phương án C: ✅ CHỐT
- 4 Sprints execution plan: ✅ User approved
Các câu hỏi mở (chưa chốt)
| # | Câu hỏi | Trạng thái |
|---|---|---|
| 1 | Real-time updates: polling hay websocket? | ⏳ Chờ Prefect setup |
| 2 | Collection task_checkpoints cần tạo khi nào? |
Sprint 1 |
| 3 | Gộp trang Tasks + Plans vào 1 view? | Sprint 4 |
| 4 | Comment notification cho agents? | ⏳ Phase sau |
Liên kết
- Design chi tiết:
design.md - Checkpoint design:
checkpoint-design.md - Workflow discussions:
../workflow-module/discussions.md - Task comments (Directus): Task #7
Mọi quyết định mới → cập nhật file này. AI Lead ghi, AI Critic verify.