SDD Orchestrator

@.claude/shared-imports/constitution.md @.claude/shared-imports/CoD_Σ.md @.claude/shared-imports/master-todo-utils.md

SDD Orchestrator Skill

Purpose

This skill orchestrates the entire Specification-Driven Development workflow by:

1. Auto-triggering on SDD-related user intents
2. Invoking sdd-coordinator agent for prerequisite validation
3. Routing to the correct phase command/skill
4. Updating plans/todos after phase completion
5. Integrating supporting skills based on feature type

Announce at start: "I'm using the SDD orchestrator skill to manage your development workflow."

Quick Reference

Workflow Files

• @.claude/skills/sdd-orchestrator/workflows/detection.md - Intent pattern matching
• @.claude/skills/sdd-orchestrator/workflows/prerequisite-check.md - Task tool invocation
• @.claude/skills/sdd-orchestrator/workflows/phase-routing.md - Route to correct phase
• @.claude/skills/sdd-orchestrator/workflows/post-phase-sync.md - Update plans/todos

Step 1: Detect SDD Intent

See: @.claude/skills/sdd-orchestrator/workflows/detection.md

Pattern Matching:

Intent_Patterns := {
  feature_creation: ["create feature", "new feature", "build", "I want to", "/feature"],
  implementation: ["implement", "code", "develop", "/implement", "start coding"],
  audit: ["audit", "verify", "check", "/audit", "validate"],
  planning: ["plan", "design", "/plan", "architecture"],
  status: ["status", "progress", "what's next", "SDD status", "where am I"],
  foundation: ["define product", "/define-product", "generate constitution", "/generate-constitution"]
}

Detection Logic:

IF user_message ∩ Intent_Patterns ≠ ∅:
  intent := matched_category
  PROCEED to Step 2
ELSE:
  SKIP orchestration (not an SDD action)

Step 2: Invoke SDD Coordinator

See: @.claude/skills/sdd-orchestrator/workflows/prerequisite-check.md

Task Tool Invocation:

Task(
  subagent_type="sdd-coordinator",
  description="SDD prerequisite validation",
  prompt="""
    Check current SDD workflow status for this project.

    User intent: {detected_intent}
    Working directory: {cwd}

    Return JSON:
    {
      "current_phase": <1-8>,
      "prerequisites_met": <true|false>,
      "missing_artifacts": ["list of missing files"],
      "blocking_issues": ["list of blockers"],
      "recommended_action": "specific command or action",
      "reason": "explanation"
    }
  """
)

Response Handling:

IF prerequisites_met = true:
  PROCEED to Step 3 (routing)
ELIF missing_artifacts ≠ []:
  REPORT missing artifacts to user
  SUGGEST prerequisite steps
ELIF blocking_issues ≠ []:
  EXPLAIN blockers
  OFFER remediation options

Step 3: Route to Correct Phase

See: @.claude/skills/sdd-orchestrator/workflows/phase-routing.md

Routing Matrix:

Invocation Method:

SlashCommand(command="/{phase_command} {args}")

Step 4: Post-Phase Sync

See: @.claude/skills/sdd-orchestrator/workflows/post-phase-sync.md

After EVERY phase completion:

4.1 Update plans/master-plan.md

IF phase ∈ {feature_creation, planning}:
  Add spec reference to master plan
  Update phase status in YAML frontmatter

4.2 Update todos/master-todo.md

IF phase = feature_creation:
  Add new feature entry to master todo
IF phase = implementation:
  Mark completed tasks with [x]
  Update progress summary

4.3 Log to event-stream.md

Append: "[{timestamp}] SDD: Phase {N} ({phase_name}) complete - {artifact_created}"

Step 5: Integrate Supporting Skills

Based on feature type detection:

Integration Method:

IF frontend_keywords ∈ spec.md:
  Load @.claude/skills/shadcn/SKILL.md context
  Load @.claude/skills/frontend-design/SKILL.md context

IF implementation_phase AND tests_required:
  Load test-driven-development patterns
  Ensure tests written before code

Error Handling

Common Errors and Recovery

Example Execution

User: "I want to create a new authentication feature"

Orchestrator Response:

I'm using the SDD orchestrator skill to manage your development workflow.

1. [DETECT] Intent: feature_creation (authentication)

2. [VALIDATE] Invoking sdd-coordinator...
   Result: {
     "current_phase": 3,
     "prerequisites_met": true,
     "recommended_action": "/feature 'authentication with OAuth'"
   }

3. [ROUTE] Prerequisites met. Invoking /feature command...

4. [POST-SYNC] After spec creation:
   - Added specs/015-authentication/spec.md reference to plans/master-plan.md
   - Added feature entry to todos/master-todo.md
   - Logged to event-stream.md

5. [INTEGRATE] Frontend keywords detected. Loading shadcn patterns...

Ready for next phase. Run /implement when audit passes.

Dependencies

Agents:

• sdd-coordinator - Prerequisite validation and workflow status

Skills:

• define-product, generate-constitution, specify-feature
• clarify-specification, create-implementation-plan, generate-tasks
• implement-and-verify, analyze-code, debug-issues
• shadcn, frontend-design, test-driven-development (supporting)

Commands:

• /feature, /plan, /tasks, /audit, /implement, /verify

Configuration

Activation Patterns (for skill description tuning):

• "create feature", "new feature", "build feature"
• "implement", "start coding", "develop"
• "SDD status", "workflow status", "what's next"
• "follow SDD", "spec-driven", "specification"
• "/feature", "/implement", "/plan", "/audit"

Reliability Target: 80%+ auto-activation on SDD-related messages

Skill Version: 1.1.0 Last Updated: 2025-12-12 Changelog:

• v1.1.0 (2025-12-12): Added Glob to allowed-tools, foundation phases detection, auto-chain docs, status fallback
• v1.0.0 (2025-12-11): Initial version - SDD workflow orchestration