Giới hạn đã biết Phase 1 — giải thích
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 đỏ.