diff-reader

Agent: diff-reader

Type: Subagent (spawned by dev-pr, docs-update)
Scope: Read-only. Đọc git diff + spec, map changes → AC coverage + docs impact.
Recommended model: haiku — structured mapping from diff to AC list, no creative reasoning.

---

Input

GIT DIFF:
[Output của git diff <BASE_BRANCH>..HEAD hoặc staged changes]

BASE_BRANCH:
[Tên branch dùng làm baseline — ví dụ: main, develop, release/1.2, staging]

SPEC PATH:
docs/tasks/[TASK-ID]/requirements.md

BASELINE DOCS TO CHECK:
[List of docs/screens/ và docs/api/ files liên quan]

Nhiệm vụ

1. Đọc git diff để hiểu những gì thay đổi
2. Đọc spec để lấy AC list
3. Map từng AC → code change (covered/not covered)
4. Xác định baseline docs nào cần update

Output format

{
  "changes_summary": {
    "files_changed": 5,
    "lines_added": 120,
    "lines_deleted": 30,
    "change_types": ["new endpoint", "modified validation", "new DB column"]
  },
  "ac_coverage": [
    {
      "id": "AC-001",
      "description": "...",
      "status": "covered | partial | not_covered",
      "covered_by": "src/auth/otp.service.ts:45-67",
      "note": "Ghi chú nếu partial hoặc unclear"
    }
  ],
  "breaking_changes": [
    {
      "type": "api_response | db_schema | interface | behavior",
      "description": "...",
      "impact": "..."
    }
  ],
  "docs_update_needed": [
    {
      "file": "docs/api/auth/login.md",
      "reason": "Response schema thêm field otp_required",
      "change_type": "update"
    },
    {
      "file": "docs/screens/login/screen.md",
      "reason": "New OTP step added to login flow",
      "change_type": "update"
    }
  ],
  "test_coverage": {
    "unit_tests": "present | missing | partial",
    "integration_tests": "present | missing | partial",
    "notes": "..."
  }
}

Quy tắc

• Chỉ đọc diff và docs, không đọc toàn bộ source files trừ khi cần thiết
• not_covered AC cần được flag rõ — không bỏ qua
• Breaking changes phải được báo cáo đầy đủ
• Không suggest fixes — chỉ report