Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
By applepig
Document-Driven Development workflow for AI-assisted software: brainstorm and spec features, plan and write Playwright E2E tests, execute TDD cycles (Red–Green–Refactor), run multi-model code and spec reviews, and diagnose bugs—all with cross-agent coordination for parallel work.
npx claudepluginhub applepig/ddd-workflowDDD 開發者 subagent——以 TDD 循環實作功能程式碼與測試。 Use this agent when dispatching implementation work during /ddd.work, when a specific task needs autonomous implementation, or when test cases need to be written for existing or planned code. Examples: <example> Context: /ddd.work 平行模式,coordinator 派發工作線給 worker user: "開始實作 milestone 3" assistant: "這個 milestone 有兩條平行工作線,我派發 ddd-developer agent 分別處理。" <commentary> Milestone 包含 🔀 可平行工作線,coordinator 需要派發獨立 worker 執行各工作線。 </commentary> </example> <example> Context: 單一 task 需要獨立實作,主 session 繼續做其他事 user: "這個 API endpoint 你派 agent 去寫,我們繼續討論下一個 milestone" assistant: "好,我派 ddd-developer 去實作 API endpoint,我們繼續規劃。" <commentary> 使用者想平行推進,派 developer agent 背景執行實作任務。 </commentary> </example> <example> Context: 功能已實作但缺少測試 user: "這個模組沒有測試,補一下" assistant: "我派 ddd-developer 分析模組行為並補上測試。" <commentary> 既有程式碼缺少測試覆蓋,需要 developer agent 補上。 </commentary> </example>
DDD 審查 subagent——獨立審查文件、規格一致性、實作與安全性風險,產出 review 報告。 Use this agent when dispatched by /ddd.xreview for cross-review, or when documents or code changes need independent review before committing. Examples: <example> Context: /ddd.xreview 派發 Claude 端的 reviewer user: "cross review 這次的變更" assistant: "我同時派出 Gemini 和 Claude reviewer 獨立審查。" <commentary> xreview 需要派出獨立的 Claude reviewer subagent,與 Gemini reviewer 平行執行。 </commentary> </example> <example> Context: Milestone 完成,提交前需要 review user: "commit 前幫我 review 一下" assistant: "我派 ddd-reviewer 審查這次的變更。" <commentary> 提交前的獨立 DDD review,確認文件、規格一致性、實作與安全性風險。 </commentary> </example>
E2E 除錯指南:用 agent-browser CLI 在 DDD 工作流中系統性除錯前端問題。 Trigger: "debug E2E", "check the page", "why is the test failing", "open the browser", "take a screenshot", "inspect the DOM", "E2E 失敗", "測試壞了", "檢查頁面", /ddd.agent-browser。 E2E 測試失敗、需要視覺驗證 UI 行為、或追蹤前端問題時使用。
腦力激盪:把模糊的 idea 從零生出完整設計,產出 plan.md。 適用於 greenfield——新專案、新模組、沒既有 code 可參考的情境;從一張白紙生出結構。 如果是既有專案的延伸擴充(brownfield),改用 /ddd.plan。 透過 clarifying questions、2-3 方案比較、分段呈現、Plan Self-Review + User Review Gate 的雙閘門確保品質。 Trigger: "brainstorm", "explore ideas", "new project", "from scratch", "greenfield", "starting a new feature", "turn an idea into a design", "think through this idea", "腦力激盪", "新專案", "從頭開始", "新功能起步", "一張白紙", "想法變設計", "幫我想清楚", /ddd.brainstorming。
E2E 測試規劃與撰寫:在 main agent context 中探索應用、規劃測試案例、撰寫 Playwright 測試。 支援 Greenfield(從 spec 驅動)和 Retrofit(既有專案補 E2E)兩種模式。 Trigger: "write E2E tests", "add E2E", "Playwright test", "test this page", "補 E2E", "幫我測這個頁面", "這個功能需要 E2E", /ddd.e2e。 任何需要 E2E 測試覆蓋的場景都應觸發。
Bug 修復:系統性診斷與修復 bug,產出三合一 works.md。 可作為 xreview 後的 proper fix,或獨立觸發的 hotfix。 Main agent 直接修,不派 ddd-developer。 Trigger: "fix bug", "fix this", "bugfix", "hotfix", "修 bug", "修這個", "這裡壞了", "有 bug", /ddd.fixbug。 發現 bug 或 xreview 後需要修正時使用。
前置規劃:既有專案中延伸/修改功能時,釐清方向、探索可能性,產出 plan.md。 適用於 brownfield——有既有 code 當錨點、要在現行架構上增修。 如果是新專案或新模組(greenfield),改用 /ddd.brainstorming。 Trigger: "plan a feature", "plan an extension", "clarify requirements", "figure out how to extend", "規劃擴充", "規劃改動", "既有系統加功能", "規劃功能", "釐清需求", /ddd.plan。 在既有 codebase 上做延伸時,即使只是粗略描述概念,也應觸發此 skill 來定型方向。
Uses power tools
Uses Bash, Write, or Edit tools
Share bugs, ideas, or general feedback.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Full SDD (Spec-Driven Development) framework for Claude Code. 72+ slash commands (/dc:*), 14 reusable skills, 15 reasoning models, TDD as an iron law, and i18n support (ES/EN/PT). Turn requirements into tested, documented, production-ready code through 7 disciplined lifecycle phases.
AI-driven development toolkit for TDD and SDD workflows, providing comprehensive command templates and agents to enhance developer productivity with Claude Code
Spec-Driven Development Workflow for Claude Code. A 6-step pipeline: Requirements → Code Analysis → Design → Implement → Verify → Self-Improve. Specifications are the source of truth, code is a verified artifact.
Persona-driven AI development team: orchestrator, team agents, review agents, skills, slash commands, and advisory hooks for Claude Code
Agent Driven Development (ADD) — Coordinated AI agent teams that ship verified software. Spec-driven TDD, trust-but-verify orchestration, human-AI collaboration protocols, environment-aware deployment, and cross-project learning.
Spec-driven development methodology for full-stack teams
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-workflow
gemini 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 -- 確認 --> NeedTasks{需要獨立 tasks?}
NeedTasks -- 否 --> Work
NeedTasks -- 是 --> Tasks
Tasks["/ddd.tasks<br/>複雜執行計畫"] --> 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、輕量 Milestones
├── tasks.md # (optional) 複雜執行計畫:平行工作線、匯合點、跨 agent 派工
└── works.md # 開發日誌:決策與問題記錄
專案初始化時先建立 PRD.md(產品目標、使用者、範圍)和 TECHSTACK.md(語言、框架、部署環境),後續每個功能的 spec 都以此為基礎。
主流程 skills(按順序使用,指令名稱與文件名皆為 alphabetical order — by design):
| Slash Command | 用途 | 何時觸發 |
|---|---|---|
/ddd.plan | 需求模糊時釐清方向,產出 plan.md | 「我有個想法…」 |
/ddd.spec | 撰寫正式規格書 spec.md,含輕量 Milestones | 需求明確,準備定義規格 |
/ddd.tasks | 必要時抽出複雜執行計畫 | spec 確認後,且需要平行派工或複雜依賴 |
/ddd.work | 以 TDD 循環實作(支援平行派工) | spec 確認後;若有 tasks,也需先確認 |
/ddd.xreview | 多模型 cross review | 實作完成,準備提交前 |
輔助 skills:
| Slash Command | 用途 |
|---|---|
/ddd.agent-browser | E2E 除錯——用瀏覽器自動化系統性地除錯前端問題 |
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