dev-analyze

Skill: /dev-analyze

Role: Developer
Mục đích: Phân tích task/issue và đề xuất các phương án thi công. Dùng multi-agent để giữ context sạch.

---

Brain Dump Pattern (input contract)

Trước khi chạy skill này, dev nên cung cấp context block sau để giảm hallucination:

Tech stack: [language, framework, DB, infra]
Relevant files: [file paths đã biết liên quan]
Constraints: [performance, security, backward compat, deadline]
Known gotchas: [vấn đề đã biết trong codebase]
Issue/Task: [link hoặc paste nội dung]

Nếu không có đủ context → skill sẽ hỏi trước khi tiếp tục.

---

Kiến trúc Multi-Agent

Skill này orchestrate các subagent để giữ context sạch:

dev-analyze (orchestrator)
├── [Subagent 1] task-reader    → parse issue → structured understanding
├── [Subagent 2] code-scout     → tìm code liên quan (read-only)
└── [Subagent 3] planner        → tổng hợp → đề xuất phương án

Mỗi subagent nhận chỉ context cần thiết, trả về kết quả nén.

Cách spawn subagent

Dùng Agent tool để spawn mỗi subagent. Prompt phải self-contained — không pass full conversation history.

Ví dụ spawn task-reader:

Agent(
  description: "Parse GitHub issue into structured JSON",
  prompt: "Read this issue and return structured JSON per agents/task-reader.md spec.\n\nISSUE CONTENT:\n[paste issue content here]",
  model: "haiku"
)

Ví dụ spawn code-scout:

Agent(
  description: "Find relevant files for auth task",
  prompt: "Find files relevant to this task. Return JSON per agents/code-scout.md spec.\n\nTASK SUMMARY: [summary]\nTECH STACK: [stack]\nAFFECTED AREAS: [areas]",
  model: "haiku"
)

Ví dụ spawn planner:

Agent(
  description: "Synthesize task + code map into implementation options",
  prompt: "Create 2-3 implementation options per agents/planner.md spec.\n\nTASK: [task-reader JSON]\nCODE MAP: [code-scout JSON]\nCONSTRAINTS: [from Gate 1]",
  model: "sonnet"
)

---

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

Bước 0 — Risk Classification

Trước khi spawn bất kỳ subagent nào, classify risk theo docs/risk-classifier.md: