Wiki hai chiều — đọc tự động, ghi bằng đề xuất

Đối tượng: member muốn agent tuân thủ convention team mà không copy-paste, và muốn tri thức mới quay về Wiki.

Chiều đọc — tri thức tự động đi vào công việc

Trước khi agent chạy, server tìm semantic search trên Arkon Wiki của Department gắn với Space, rồi ghi vào worktree:

<worktree>/.board/wiki/
├── INDEX.md                    ← mục lục các trang đã bơm
├── coding-standards.md
└── payment-architecture-adr.md

.board/task.json chỉ agent đọc INDEX.md trước khi viết code. Nhờ vậy agent tuân thủ convention của team mà bạn không phải copy-paste.

Tab Wiki trống / INDEX.md ghi "No wiki pages available"?

Arkon không kết nối được và suy biến mềm đang che nó. Xem Wiki tắt lặng — 4 dấu hiệu.

Chiều ghi — agent đề xuất, người duyệt

Agent ghi wikiProposals[] trong .board/result.json:

{
  "success": true,
  "summary": "Thêm webhook VNPay + retry policy",
  "filesChanged": ["src/payment/vnpay.ts", "src/payment/vnpay.test.ts"],
  "wikiProposals": [
    {
      "contentMd": "# ADR-014: Retry policy cho VNPay webhook\n\nQuyết định: retry 3 lần, backoff…",
      "note": "Sinh ra từ task PAY-101"
    }
  ]
}

Server ingest thành draft Arkon sau khi task complete. Bạn vào Wiki View → Review Queue xem draft; duyệt do admin làm (xem Duyệt Wiki draft).

Nạp tài liệu gốc vào Wiki làm bên Arkon :3119: Knowledge → Upload Source → pipeline MRP phân tích → bạn Approve Plan → Arkon biên dịch cây trang liên kết chéo. Chi tiết: Nạp tài liệu vào Wiki.

Checklist tự xác minh

• Trong worktree của task đang chạy, .board/wiki/INDEX.md tồn tại và không rỗng.
• Sau khi agent xong, Review Queue có draft mới từ wikiProposals.