double-diamond
Universal multi-agent orchestration workflow based on the Double Diamond framework (Inception -> Discovery -> Definition -> Development -> Delivery). Coordinates parallel subagents with context isolation to separate problem-space research from solution-space implementation. Activate for complex, high-ambiguity initiatives across software engineering, in-depth research, long-form writing, legal analysis, or product strategy requiring structured human alignment gates.
Daniela Petruzalek (daniela@danicat.dev) · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add danicat/skills --skill double-diamond技能说明
name: double-diamond description: > Universal multi-agent orchestration workflow based on the Double Diamond framework (Inception -> Discovery -> Definition -> Development -> Delivery). Coordinates parallel subagents with context isolation to separate problem-space research from solution-space implementation. Activate for complex, high-ambiguity initiatives across software engineering, in-depth research, long-form writing, legal analysis, or product strategy requiring structured human alignment gates. license: Apache-2.0 metadata: category: agents tags: "orchestration, workflow, research, planning, subagents, agile" author: Daniela Petruzalek (daniela@danicat.dev) version: "0.2.1" catalog: https://skills.danicat.dev
Double-Diamond Multi-Agent Orchestration
The double-diamond skill coordinates complex, high-ambiguity initiatives through the proven Double Diamond framework, preceded by an Inception alignment phase. It leverages parallel subagents with context isolation to thoroughly explore the problem space before committing to solution-space implementation.
INCEPTION PHASE
(Pre-Diamond Alignment)
/grill-me User Interview
Establish Shared Understanding
│
▼
DIAMOND 1: PROBLEM SPACE DIAMOND 2: SOLUTION SPACE
(Research & Exploration) (Creation & Verification)
/--- Discovery (Diverge) ---\ /--- Development (Diverge) ---\
/ Parallel `research` sub- \ / Parallel creation sub- \
/ agents explore landscape, \ / agents craft disjoint \
Start > constraints & prior art > Brief > sections/modules in parallel > Delivery
\ / Gate \ / (Gates)
\--- Definition (Converge) --/ \--- Delivery (Converge) ----/
Synthesize findings into Holistic review, integration,
a Foundation Document and quality gate verification
🌐 Universal Domain Mapping
Double Diamond adapts seamlessly across technical, creative, and analytical domains:
| Phase | Software Engineering | Writing & Publishing | Legal & Policy Research | Product & Strategy |
|---|---|---|---|---|
| 0. Inception | Stack, constraints, latency, scope | Audience, tone, thesis, length | Jurisdiction, case theory, facts | Market, user persona, success metrics |
| 1. Discover (Diverge) | Codebase, APIs, edge cases | Background research, angles, data | Precedents, statutes, case law | Competitor analysis, customer interviews |
| 2. Define (Converge) | Technical Specification | Structured Editorial Outline | Legal Brief / Argument Structure | PRD / Feature Specification |
| Steering Gate | Approve architecture & trade-offs | Approve thesis & outline | Approve legal theory & approach | Sign off on product direction |
| 3. Develop (Diverge) | Parallel module implementation | Parallel chapter/section drafting | Parallel argument/motion drafting | Parallel prototype/stream exploration |
| 4. Deliver (Converge) | Build, tests, lint, spec compliance | Fact-check, style, voice, flow | Citation audit, counter-arguments | Executive synthesis, launch readiness |
⚡ Core Principles & Operational Rules
- Pre-Diamond Inception (Alignment Gate):
- Before launching research divergence, the Coordinator executes an Inception phase via the
/grill-meinteractive interview protocol (usingask_question). - The Coordinator explores the existing environment/context first, then interviews the user about goals, constraints, non-negotiables, target audience, and deliverable modality.
- Before launching research divergence, the Coordinator executes an Inception phase via the
- Two Distinct Diamond Phases (Problem Space vs. Solution Space):
- Diamond 1 (Problem Space): Focuses exclusively on reconnaissance, constraint mapping, dependency analysis, and definition. No final deliverable code or prose is authored during Diamond 1.
- Diamond 2 (Solution Space): Focuses on parallel creation against the approved definition, followed by rigorous quality gating.
- Context Isolation via Subagents:
- Deep exploration and multi-track creation happen in isolated subagent contexts (
researchfor read-only exploration,selffor creation). This prevents context pollution and hallucination in the Coordinator's session.
- Deep exploration and multi-track creation happen in isolated subagent contexts (
- Mandatory User Steering Gate (Human-in-the-Loop Alignment):
- Between Diamond 1 and Diamond 2, the Coordinator halts to present the synthesized Foundation Document (Spec, Outline, Brief, or PRD) and trade-offs to the user for explicit review and confirmation.
- Disjoint Work Allocation (Zero Collision):
- In Diamond 2 (Development), parallel creator subagents receive strictly disjoint assignments (e.g., distinct source files, separate article sections, independent legal claims) to prevent overwrite collisions.
- Domain-Specific Delivery Quality Gates:
- Work is not delivered until all domain-specific quality gates pass: structural integrity, localized unit/section verification, holistic consistency, and compliance with the approved Foundation Document.
🎯 Agent Budget & Degree of Parallelism (DOP)
- Definition: Agent Budget is synonymous with Degree of Parallelism (DOP). It defines the maximum number of active, concurrent subagents allowed to execute at the exact same time.
- Active vs. Past Capacity: Completed or terminated subagents do not consume budget. The budget applies strictly to currently running subagents. When a subagent completes its work, its concurrency slot is immediately freed.
- Elastic Scaling: While the baseline default is DOP = 4, the framework scales elas