sdd-2c-workshop

name: sdd-2c-workshop description: "Deep design exploration for Workshop Opportunities identified in a specification. Use when: a spec has Workshop Opportunities that need detailed design analysis before clarification, or when a complex topic needs structured option evaluation."

SDD Phase 2c: Workshop

Create detailed design documents for complex topics identified in a specification's Workshop Opportunities table.

Inputs

• slug (Optional): Slug from prior phases. Inferred from context if omitted.
• topic (Optional): Specific workshop topic to explore. If omitted, present the Workshop Opportunities table for user selection.

Step 0: Doctrine Resolution

Before starting, resolve project conventions:

1. Check for project doctrine files:
   • docs/project-rules/ (constitution.md, rules.md, idioms.md, architecture.md)
   • copilot-instructions.md, AGENTS.md, CONTRIBUTING.md, README.md
2. If no doctrine found, scan the codebase for dependency manifests, build systems, and directory patterns.
3. Extract: build command, test command, coverage threshold, naming conventions, CI platform.
4. Unknown values become explicit [TODO] markers — never assume silently.

Step 1: Load Workshop Context

1. Read the specification from .copilot-tracking/plans/{date}/{slug}/{slug}-spec.md.
2. Locate the ## Workshop Opportunities table.
3. If {topic} is provided, find the matching row. If not found, list available topics and ask the user to select one.
4. If {topic} is not provided, present the table and ask the user to select a topic.

Step 2: Research the Topic

Launch a focused research investigation on the selected topic:

1. Codebase Evidence — search for existing implementations, patterns, or prior art related to the topic.
2. Constraint Discovery — identify technical constraints, platform limitations, or doctrine rules that affect the topic.
3. Decision Record Scan — check docs/decision-records/ for existing ADRs that inform or constrain the topic.

Step 3: Create Workshop Document

Create the workshop document at .copilot-tracking/plans/{date}/{slug}/workshops/{topic-slug}.md with these sections:

# Workshop: {Topic Name}

**Date:** {today}
**Type:** {Type from Workshop Opportunities table}
**Priority:** {Priority from Workshop Opportunities table}
**Spec:** {slug}-spec.md

## Problem Statement

{Why this topic needs deeper design exploration — from the "Why It Matters" column}

## Current State

{What exists today in the codebase relevant to this topic, with file:line evidence}

## Options

### Option A: {Name}

{Description, trade-offs, constraints}

### Option B: {Name}

{Description, trade-offs, constraints}

### Option C: {Name} (if applicable)

{Description, trade-offs, constraints}

## Recommendation

{Which option is recommended and why}

## Decision

{Left blank for user to fill after review, or "Pending workshop discussion"}

## Impact on Specification

{How the chosen option would affect the spec's goals, acceptance criteria, or complexity score}

Include diagrams (Mermaid) where they clarify relationships, data flows, or state transitions.

Step 4: Present for Review

Present the workshop document to the user. Note any findings that should feed back into the specification or that warrant an ADR.

[!IMPORTANT] STOP. Present the workshop document to the user. The user decides whether to update the spec, create an ADR, or proceed to clarification.