Document Driven Development 工作流——讓 AI agent 用結構化的文件驅動開發，而非直接跳進程式碼。
No Code Without Docs, No Code Without Tests.
每個功能都從文件開始：先釐清需求、寫 spec、拆 tasks，確認後才動手寫程式碼。Main agent 擔任 Coordinator（規劃、派工、驗收），實作和 review 交給專屬 subagent，保護 main agent 的 context window 不被消耗。
claude plugin add github:applepig/ddd-workflowgemini extensions install https://github.com/applepig/ddd-workflow.git本專案遵循標準的 skills/agents 目錄結構。如果你的 agent CLI 支援從目錄載入 skills，可以手動 clone 後 symlink：
git clone https://github.com/applepig/ddd-workflow.git
# 將 skills/、agents/、references/AGENTS.md 連結到你的 agent 設定目錄flowchart TD
Start([新專案]) --> Init["建立 docs/<br/>PRD.md + TECHSTACK.md"]
Init --> Feature([提出功能需求])
Feature --> Clarity{需求明確？}
Clarity -- 模糊 --> Plan["/ddd.plan<br/>釐清方向、產出 plan.md"]
Plan --> Spec
Clarity -- 明確 --> Spec["/ddd.spec<br/>撰寫 spec.md"]
Spec --> UserSpec{使用者確認 spec？}
UserSpec -- 修改 --> Spec
UserSpec -- 確認 --> Tasks
Tasks["/ddd.tasks<br/>拆解為 milestone + task"] --> UserTasks{使用者確認 tasks？}
UserTasks -- 修改 --> Tasks
UserTasks -- 確認 --> Work
Work["/ddd.work<br/>TDD 循環實作"] --> Review
Review["/ddd.xreview<br/>Cross review（多模型獨立審查）"] --> Fix{需要修正？}
Fix -- 是 --> Work
Fix -- 否 --> Next{還有下一個功能？}
Next -- 是 --> Feature
Next -- 否 --> Done([完成])
flowchart LR
User([使用者]) <--> Coord
subgraph Main["Main Agent（Coordinator）"]
Coord[規劃 / 派工 / 驗收]
end
Coord --> Dev["ddd-developer<br/>TDD 實作"]
Coord --> Rev["ddd-reviewer<br/>程式碼審查"]
Dev --> Coord
Rev --> Coord
| 角色 | 職責 | 不做什麼 |
|---|---|---|
| Coordinator（main agent） | 需求分析、撰寫 spec、拆解 tasks、派工、驗收 | 不寫 production code、不 debug、不做 review |
| ddd-developer | 以 TDD 循環實作功能程式碼與測試 | 不做架構決策、不跳過測試 |
| ddd-reviewer | 獨立審查程式碼變更，產出 review 報告 | 不修改程式碼 |
每個需求對應一個文件包，作為 SSOT（Single Source of Truth）：
docs/
├── PRD.md # 產品需求文件（專案層級，只建一次）
├── TECHSTACK.md # 技術棧 + 參考文件連結（專案層級，只建一次）
└── <編號>-<名稱>/ # Sprint 文件包（每個功能一個）
├── plan.md # (optional) 前置規劃
├── research.md # (optional) 技術調研
├── spec.md # 規格書：User Story、驗收條件、ADR
├── tasks.md # Milestone + task checklist
└── works.md # 開發日誌：決策與問題記錄
專案初始化時先建立 PRD.md（產品目標、使用者、範圍）和 TECHSTACK.md（語言、框架、部署環境），後續每個功能的 spec 都以此為基礎。
主流程 skills（按順序使用，指令名稱與文件名皆為 alphabetical order — by design）：
| Slash Command | 用途 | 何時觸發 |
|---|---|---|
/ddd.plan |
需求模糊時釐清方向，產出 plan.md | 「我有個想法…」 |
/ddd.spec |
撰寫正式規格書 spec.md | 需求明確，準備定義規格 |
/ddd.tasks |
將 spec 拆解為 milestone + task checklist | spec 確認後 |
/ddd.work |
以 TDD 循環實作（支援平行派工） | tasks 確認後，開始寫 code |
/ddd.xreview |
多模型 cross review | 實作完成，準備提交前 |
輔助 skills：
| Slash Command | 用途 |
|---|---|
/ddd.architect-refactor |
架構層級重構——模組邊界、依賴方向、職責分配 |
/ddd.agent-browser |
E2E 除錯——用瀏覽器自動化系統性地除錯前端問題 |
/ddd.create-hooks |
設定 Claude Code hooks（安全防護、lint、commit review） |
- SSOT：每個需求一個文件包，文件就是唯一真相來源
- No Code Without Docs：spec + tasks 獲得確認前，嚴禁寫程式碼
- No Code Without Tests：修改 production code 前，必須先有測試
- Sync on Finish：完成任務前，先更新 tasks.md 和 works.md
- 明確的決策點：需要使用者決策時，必須暫停等待確認
ddd-workflow/
├── skills/ # Skill 定義（slash commands）
│ └── ddd.<name>/
│ ├── SKILL.md # YAML frontmatter + 指令內容
│ └── references/ # (optional) 參考資料
├── agents/ # Subagent 定義
│ └── ddd-<role>.md # YAML frontmatter + system prompt
└── references/
└── AGENTS.md # 共用指令檔（coding style、工具偏好等）
MIT