docs-update

Skill: /docs-update

Role: Developer / QA (sau verify)
Mục đích: Cập nhật Baseline Docs (screen + API) sau khi task đã verify và merge. Đây là bước CUỐI CÙNG của mọi task.

---

Quan trọng

Baseline Docs là nguồn sự thật cho team. Cập nhật sai = technical debt.
Skill này luôn đề xuất thay đổi để human review, không tự động ghi đè.

---

Hướng dẫn thực hiện

Bước 1 — Spawn subagent: diff-reader

Spawn subagent để đọc:

• git diff [base-branch]..HEAD -- docs/ — docs đã thay đổi chưa?
• git diff [base-branch]..HEAD -- [src/] — code thay đổi gì?
• docs/tasks/[TASK-ID]/requirements.md — spec gốc

Agent(
  description: "Map merged code changes to baseline docs that need updating",
  prompt: "Read git diff and spec, return docs impact per agents/diff-reader.md spec.\n\nGIT DIFF:\n[git diff base-branch..HEAD]\n\nSPEC PATH: docs/tasks/[TASK-ID]/requirements.md\n\nBASELINE DOCS TO CHECK: [list docs/screens/ and docs/api/ files related to this task]",
  model: "haiku"
)

Subagent trả về: danh sách thay đổi cần reflect vào docs.

Bước 1b — Spawn subagent: doc-updater

Sau khi nhận output từ diff-reader, spawn doc-updater để tạo proposals:

Agent(
  description: "Propose specific content changes for each baseline doc",
  prompt: "Create update proposals per agents/doc-updater.md spec.\n\nDIFF READER OUTPUT:\n[JSON từ diff-reader]\n\nCURRENT DOC CONTENT:\n[Nội dung hiện tại của từng file trong docs_update_needed]\n\nCHANGES SUMMARY:\n[changes_summary từ diff-reader]",
  model: "sonnet"
)

Bước 2 — Gate: Xác nhận scope update

## Task [TASK-ID] đã verify và merge.

Tôi phân tích code changes và thấy cần update docs:

**Screen docs cần update**:
- `docs/screens/[feature]/screen.md` — [lý do: field mới / flow thay đổi / ...]

**API docs cần update**:
- `docs/api/[domain]/[endpoint].md` — [lý do: response format thay đổi / new endpoint / ...]

**Không cần update**:
- [Những file docs không bị ảnh hưởng]

| | Lựa chọn |
|---|---------|
| A | Không, đủ rồi |
| B | Có — docs bỏ sót: ___ |
| C | Khác: ___ |