Skip to content

ilandahan/AID / skills/aid-discovery

aid-discovery

Verified

AID Phase 0 - Research & discovery. Use for validating problem spaces, identifying stakeholders, defining success metrics, deciding whether to proceed.

FileKindSize
SKILL.extended.mdmarkdown6.1 KB
SKILL.mdskill md2.2 KB
references/discovery-workshop-guide.mdmarkdown2.5 KB
references/feasibility-assessment.mdmarkdown3.4 KB

references/discovery-workshop-guide.md

View on GitHub
# Discovery Workshop Guide

## Workshop Structure

### Session 1: Problem Definition (60 min)
1. **Icebreaker** (5 min) - Quick intros
2. **Current State Mapping** (20 min) - What exists today
3. **Pain Point Collection** (20 min) - What's broken
4. **Impact Quantification** (15 min) - Cost of pain

### Session 2: Stakeholder Mapping (45 min)
1. **Brainstorm Stakeholders** (15 min)
2. **Categorize by Influence/Impact** (15 min)
3. **Identify Communication Needs** (15 min)

### Session 3: Success Definition (45 min)
1. **Define Success State** (15 min) - What does "done" look like?
2. **Identify Metrics** (15 min) - How do we measure?
3. **Set Targets** (15 min) - What numbers matter?

## Facilitation Tips

### Do
- Ask open-ended questions
- Capture everything, filter later
- Encourage quiet voices
- Challenge assumptions
- Quantify whenever possible

### Don't
- Jump to solutions
- Let one person dominate
- Dismiss concerns
- Accept vague answers
- Skip stakeholders

## Problem Validation Techniques

### 5 Whys Example
```
Statement: "We need a new dashboard"
Why? → "Current one is slow"
Why? → "Too much data loading"
Why? → "Users need all metrics at once"
Why? → "They're comparing across regions"
Why? → "Regional performance isn't visible easily"

Root Problem: Regional performance comparison is difficult
Solution might not be: New dashboard
Solution might be: Regional summary view
```

### Jobs-to-be-Done Format
```
When [situation]
I want to [motivation]
So I can [outcome]
```

## Stakeholder Power/Interest Grid

```
           High Interest
                │
    Keep       │    Manage
    Satisfied  │    Closely
               │
───────────────┼───────────────
               │
    Monitor    │    Keep
    (Minimum)  │    Informed
               │
           Low Interest

High Power ←───────────→ Low Power
```

## Output Templates

### Problem Statement (SCQ)
```markdown
## Situation
[What is the current state?]

## Complication
[What has changed or is wrong?]

## Question
[What question does solving this answer?]

## Quantified Impact
- Time lost: X hours/week
- Cost: $Y/month
- Users affected: Z people
```

### Stakeholder Register
```markdown
| Name/Role | Type | Interest | Influence | Communication |
|-----------|------|----------|-----------|---------------|
| [Name] | Decision Maker | High | High | Weekly update |
| [Name] | End User | High | Low | Release notes |
| [Name] | System Owner | Medium | High | Review meetings |
```
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall