microsoft/sdd-walkthrough

SDD Walkthrough

Purpose: Load this when about to orchestrate an execute-plan session. Provides concrete worked examples of all five common task outcomes so you know exactly what delegate() calls to make and how to respond to each reviewer verdict.

Why This Skill Exists

The subagent-driven-development skill describes the process. This skill shows it in action — real delegate() call syntax, realistic reviewer responses, and the decisions an orchestrator makes at each step. Reference it before you start so the patterns are fresh when edge cases appear.

Scenarios Covered

| # | Task | Outcome Pattern | Key Technique | |---|------|-----------------|---------------| | 1 | Validate email format | Happy path: DONE → spec PASS → quality PASS | context_depth='none', model_role='coding' | | 2 | Domain reachability check | Spec gap caught: impl raises instead of returns False | Re-delegate with specific gap description | | 3 | In-memory rate limiter | DONE_WITH_CONCERNS: multi-worker incompatibility | Note concern, proceed to review, surface to user | | 4 | Validation endpoint wiring | Quality issues: magic number + missing error handling | Fix loop with attempt counter in instruction | | 5 | Error response handler | NEEDS_CONTEXT: can't find error format | Grep investigation, re-delegate with discovery |

Companion File

See five-task-example.md for the complete worked example — all five tasks with full delegate() calls, implementer/reviewer responses, fix loops, and a completion summary.

Quick Reference: delegate() Call Shapes

# Implementer — always fresh context, coding model
delegate(
    agent="superpowers:implementer",
    instruction="...",   # full task spec + scene-setting context
    context_depth="none",
    model_role="coding",
)

# Spec reviewer — needs recent agent results to see what was built
delegate(
    agent="superpowers:spec-reviewer",
    instruction="...",   # task spec + commit refs
    context_depth="recent",
    context_scope="agents",
)

# Code quality reviewer — same context shape as spec reviewer
delegate(
    agent="superpowers:code-quality-reviewer",
    instruction="...",   # commit refs + what was changed
    context_depth="recent",
    context_scope="agents",
)

Status Handling Cheat Sheet

| Status | Meaning | Orchestrator Action | |--------|---------|---------------------| | DONE | Task complete, tests pass | Proceed to spec review | | DONE_WITH_CONCERNS | Complete but flagged an issue | Read concern, note it, proceed to review | | NEEDS_CONTEXT | Missing info to proceed | Investigate (grep/read), re-delegate with context | | BLOCKED | Cannot complete at all | Assess blocker, provide context or escalate |