Giới hạn đã biết của Phase 1
Trang này liệt kê những giới hạn đã biết của Phase 1, cách xoay tạm cho từng giới hạn và cách phân biệt chúng với bug.
Những dòng dưới đây không phải bug — đừng báo lỗi chúng. Mỗi giới hạn kèm cách xoay hiện tại và hướng đã định (Stage K / K5).
Đã nối và chạy (đừng lo)
| Cơ chế | Trạng thái | Ghi chú |
|---|---|---|
| Bơm Wiki vào worktree (deadline 8s) | ✅ đã nối | Tắt bằng AGENTBOARD_WIKI_CONTEXT=0 |
Agent đề xuất Wiki (wikiProposals) | ✅ đã nối | Ingest thành draft sau complete |
| Reviewer Agent độc lập | ✅ đã nối | auto cần LLM thật; heuristic cho E2E; người vẫn duyệt cuối ở human-gate |
Repair loop result.json (2 vòng, 5m/vòng) | ✅ đã nối | Fallback trích xuất regex nếu vẫn sai; tắt bằng AGENTBOARD_BOARD_REPAIR=0 |
Chi tiết kỹ thuật: Hợp đồng .board/.
Chưa có (cách xoay)
| Giới hạn | Cách xoay |
|---|---|
| MCP write trực tiếp (K5) | Dùng đường file (.board/wiki/**, wikiProposals) — .mcp.json chưa ghi là chủ ý |
@mention subtask (Stage K) | Tạo task con thủ công |
| Theo dõi chi phí token (Stage K) | Xem dashboard của provider |
withRepoLock chỉ trong 1 process | Không chạy git tay trong repo gốc khi agent đang chạy; không chạy nhiều instance cùng repo |
| Test Arkon từng mỏng (7 file test / 21 router → nay gate pytest xanh) | Kiểm thủ công các luồng Arkon quan trọng theo MANUAL-TEST-PLAN |
Bài học được giữ lại bằng test
Vì sao 809 test xanh mà 4 cơ chế vẫn lọt (có test nhưng không có call site)? Vì unit test gọi trực tiếp
vào hàm, không chứng minh có ai gọi hàm. Ratchet chống tái phát: tests/wiring-liveness.test.ts quét
src/**/*.ts và assert mỗi hàm có call site được pin ở agent-manager.ts — xóa call site là CI đỏ.
Đi tiếp: Hợp đồng .board/ · Suy biến mềm Arkon · Xử lý sự cố