skillweave-discovery

facade	true
experimental	true
name	skillweave-discovery
description	Define and validate problems through stakeholder research, empathy mapping, evidence, and opportunity assessment.
argument-hint	topic="[topic]" domain="[domain]" mode="[quick|deep]"

/skillweave-discovery

Canonical metadata is English. User-facing artifacts follow the output language setting.

Define the right problem before building the wrong solution. Empathy-driven research, problem framing, and opportunity validation for multi-agent AI development.

Mandatory Pre-Flight: SkillWeave Sandboxing

Before generating output, verify and enforce:

1. Directory: Create .skillweave/ with discovery/, prds/, tracking-log/ subdirs if missing.
2. Routing: ALL artifacts go under .skillweave/discovery/ — never the repo root.
3. Git: Append .skillweave/ to .gitignore if not present.
4. Pre-Scan: Scan .skillweave/prds/ for existing PRDs. If found, flag and ask whether to update or skip discovery.

Phases

Phase 1: Empathy

Understand stakeholders, users, and their unmet needs.

Step	Description	Artifact
1.1	Problem exploration	.skillweave/discovery/problem-exploration.md
1.2	User persona creation	.skillweave/discovery/user-persona.md
1.3	Empathy map	.skillweave/discovery/empathy-map.md
1.4	Stakeholder mapping	.skillweave/discovery/stakeholder-map.md

Phase 2: Research

Gather evidence, validate assumptions, analyze the landscape.

Step	Description	Artifact
2.1	Competitive landscape	.skillweave/discovery/competitive-landscape.md
2.2	Market analysis	.skillweave/discovery/market-analysis.md
2.3	User interview synthesis	.skillweave/discovery/user-interview.md
2.4	Assumption mapping	.skillweave/discovery/assumption-map.md

Phase 3: Framing

Synthesize findings into a crisp problem statement and assess opportunity.

Step	Description	Artifact
3.1	Problem statement	.skillweave/discovery/problem-statement.md
3.2	Opportunity assessment	.skillweave/discovery/opportunity-assessment.md

Phase 4: Output

Deliver a consolidated discovery report consumable by skillweave-blueprint.

Step	Description	Artifact
4.1	Discovery report	.skillweave/discovery/discovery-report.md

Blueprint Integration

skillweave-blueprint reads discovery output to seed the PRD interview:

• Problem Statement → problem section in blueprint PRD
• Decision Record → constraints / assumptions in blueprint PRD
• Persona + Stakeholder Map → target_audience in blueprint PRD

Blueprint scans .skillweave/discovery/ for the discovery report. If present, it skips exploration preamble and jumps to solution-oriented questions.

Testing

Check	Criteria
Prompts accessible	All 11 reference prompts load from references/discovery-prompts.md
Output valid	Each phase artifact is valid markdown with required sections
Blueprint detects status	Blueprint pre-scan correctly identifies .skillweave/discovery/ contents
Sandbox enforced	All artifacts land under .skillweave/discovery/