workshop

What this skill does

# Workshop Command

Facilitate structured requirements workshops following Joint Application Development (JAD) patterns.

## Interactive Workshop Configuration

Use AskUserQuestion to configure the workshop session:

```yaml
# Question 1: Workshop Format (MCP: JAD methodology patterns)
question: "What type of requirements workshop do you need?"
header: "Format"
options:
  - label: "Discovery (Recommended)"
    description: "Explore and understand the problem space"
  - label: "JAD (Full)"
    description: "Comprehensive requirements definition with all stakeholders"
  - label: "Refinement"
    description: "Clarify and decompose existing requirements"
  - label: "Prioritization"
    description: "Reach consensus on requirement priorities"

# Question 2: Session Duration (MCP: CLI best practices - scope selection)
question: "How long should the workshop session be?"
header: "Duration"
options:
  - label: "Short (Recommended)"
    description: "30 minutes - focused, single objective"
  - label: "Standard"
    description: "2 hours - full workshop with all phases"
  - label: "Extended"
    description: "4+ hours - comprehensive multi-session workshop"
```

Use these responses to tailor workshop format and time allocation.

## Usage

```bash
/requirements-elicitation:workshop
/requirements-elicitation:workshop --domain "inventory"
/requirements-elicitation:workshop --domain "crm" --format discovery
/requirements-elicitation:workshop --domain "billing" --format prioritization --duration short
```

## Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| --domain | No | Domain for the workshop (default: current/most recent) |
| --format | No | Workshop format: `jad`, `discovery`, `refinement`, `prioritization` (default: `jad`) |
| --duration | No | Expected duration: `short` (30m), `standard` (2h), `extended` (4h+) (default: `standard`) |

## Workshop Formats

### JAD (Joint Application Development)

Comprehensive requirements workshop format.

```yaml
jad_workshop:
  purpose: "Collaborative requirements definition with all stakeholders"
  participants:
    required:
      - "Executive sponsor"
      - "Business stakeholders"
      - "End users (representatives)"
      - "Technical team"
    optional:
      - "Subject matter experts"
      - "Compliance/legal"

  agenda:
    1_opening:
      duration: "15 min"
      activities:
        - "Welcome and introductions"
        - "Review objectives and ground rules"
        - "Confirm scope boundaries"

    2_context:
      duration: "30 min"
      activities:
        - "Present current state"
        - "Review known requirements"
        - "Identify gaps and pain points"

    3_requirements:
      duration: "60 min"
      activities:
        - "Brainstorm requirements by category"
        - "Clarify and refine each requirement"
        - "Identify dependencies and conflicts"
        - "Capture acceptance criteria"

    4_prioritization:
      duration: "30 min"
      activities:
        - "Apply MoSCoW or other method"
        - "Resolve priority conflicts"
        - "Define MVP scope"

    5_wrap_up:
      duration: "15 min"
      activities:
        - "Summarize decisions"
        - "Identify action items"
        - "Schedule follow-ups"
```

### Discovery Workshop

Focus on exploring and understanding the problem space.

```yaml
discovery_workshop:
  purpose: "Understand the problem before defining solutions"

  agenda:
    1_problem_statement:
      duration: "20 min"
      activities:
        - "What problem are we solving?"
        - "Who experiences this problem?"
        - "What's the impact of not solving it?"

    2_stakeholder_mapping:
      duration: "20 min"
      activities:
        - "Identify all stakeholders"
        - "Map their interests and influence"
        - "Note conflicting perspectives"

    3_current_state:
      duration: "30 min"
      activities:
        - "How is the problem handled today?"
        - "What workarounds exist?"
        - "What works well? What doesn't?"

    4_desired_state:
      duration: "30 min"
      activities:
        - "What does success look like?"
        - "What outcomes matter most?"
        - "What constraints exist?"

    5_gap_analysis:
      duration: "20 min"
      activities:
        - "What's missing to get from current to desired?"
        - "What are the biggest obstacles?"
        - "What questions remain unanswered?"
```

### Refinement Workshop

Deep dive into specific requirements for clarity and completeness.

```yaml
refinement_workshop:
  purpose: "Clarify, decompose, and validate existing requirements"

  agenda:
    1_review:
      duration: "15 min"
      activities:
        - "Review requirements to refine"
        - "Identify ambiguities"
        - "Note questions and concerns"

    2_clarification:
      duration: "45 min"
      per_requirement:
        - "Read requirement aloud"
        - "Identify vague terms"
        - "Define acceptance criteria"
        - "Capture edge cases"

    3_decomposition:
      duration: "30 min"
      activities:
        - "Break large requirements into smaller pieces"
        - "Identify hidden sub-requirements"
        - "Map dependencies"

    4_validation:
      duration: "20 min"
      activities:
        - "Verify with stakeholders"
        - "Check for completeness"
        - "Confirm priority still accurate"

    5_documentation:
      duration: "10 min"
      activities:
        - "Update requirement statements"
        - "Document decisions made"
        - "Note open questions"
```

### Prioritization Workshop

Focused session for requirement prioritization decisions.

```yaml
prioritization_workshop:
  purpose: "Reach consensus on requirement priorities"

  agenda:
    1_context:
      duration: "10 min"
      activities:
        - "Review constraints (time, budget, resources)"
        - "Confirm prioritization criteria"
        - "Select prioritization method"

    2_scoring:
      duration: "40 min"
      activities:
        - "Apply selected method (MoSCoW, WSJF, etc.)"
        - "Capture individual scores"
        - "Identify disagreements"

    3_conflict_resolution:
      duration: "20 min"
      activities:
        - "Discuss divergent scores"
        - "Present different perspectives"
        - "Reach consensus or escalate"

    4_finalization:
      duration: "10 min"
      activities:
        - "Document final priorities"
        - "Define MVP scope"
        - "Plan for deferred items"
```

## Workshop Workflow

### Pre-Workshop

```yaml
pre_workshop:
  1. Identify and invite participants
  2. Distribute pre-read materials
  3. Prepare agenda and templates
  4. Set up collaboration tools
  5. Define ground rules
```

### During Workshop

```yaml
during_workshop:
  facilitator_responsibilities:
    - "Keep discussion on track"
    - "Ensure all voices are heard"
    - "Capture decisions and action items"
    - "Manage time"
    - "Resolve or park conflicts"

  capture_template:
    requirement:
      id: "REQ-xxx"
      statement: "..."
      rationale: "Why is this needed?"
      source: "Who requested this?"
      priority: "must|should|could|wont"
      acceptance_criteria: ["..."]
      questions: ["..."]
      decisions: ["..."]
```

### Post-Workshop

```yaml
post_workshop:
  1. Consolidate notes and decisions
  2. Distribute summary to participants
  3. Update requirements repository
  4. Schedule follow-up sessions
  5. Track action items to completion
```

## Workshop Output

```yaml
workshop_report:
  metadata:
    domain: "{domain}"
    format: "jad"
    date: "{ISO-8601}"
    duration: "2 hours"
    facilitator: "Claude AI"

  participants:
    present:
      - role: "Product Owner"
        name: "Simulated"
      - role: "End User Rep"
        name: "Simulated"
      - role: "Technical Lead"
        name: "Simulated"

  agenda_outcomes:
    opening:
      objectives_confirmed: true
      scope_boundaries: ["...", "..."]

    conte