SKILL.md
Context: Create or update docs/product/vision.md with Product Outcomes, Business Outcomes, NSM, design principles, and strategic priorities.
Execution Decision Flow
1. Context Assessment
Input: Use the path or text supplied with the explicit skill invocation. If no input was supplied and the target cannot be inferred unambiguously, ask for it.
| Situation | Mode | Action |
|---|---|---|
No docs/product/vision.md exists |
Create | Full vision definition |
| Vision exists, triggered by reflection | Update | Review and update specific sections |
| Vision exists, strategic pivot | Update | Re-evaluate outcomes and priorities |
2. Vision Definition
Use references/vision-template.md to structure the vision:
New Product (Create Mode)
- Product Vision: What does this product aspire to become? (2-3 sentences)
- Design Vision: How should the product feel to users?
- Business Outcomes: What business results does the product contribute to?
- Product Outcomes: What team-controllable product goals drive those business results?
- NSM: What single metric connects Product Outcomes to Business Outcomes?
Existing Product (Update Mode)
- Review current vision against
docs/product/learnings.mdwhen that file exists - Assess whether Product Outcomes are still the right targets
- Evaluate NSM — still the right connecting metric?
- Update specific sections based on trigger
3. Design Principles
Define or review the small set of product-specific design principles needed to resolve recurring design trade-offs:
- Each principle should resolve a specific design trade-off
- Principles guide all design decisions across the product
- Write to
docs/product/design-principles.md
4. Strategic Priorities
When the current request includes cycle planning, define priorities:
- Map priorities to Product Outcomes
- Identify key Opportunities per priority
- Document strategic bets (outcome-level hypotheses)
Present the complete vision to the user for the product-strategy decision:
- Product vision and design vision
- Outcome structure (Business → Product → NSM)
- Design principles
- Strategic priorities for current cycle
- Strategic bets with confidence levels
End the current turn with the vision draft as the workflow output. Write files only after the user confirms that draft in a later turn.
5. File Output
After that confirmation:
- Write or update
docs/product/vision.md - Write or update
docs/product/design-principles.md
Scope Boundaries
Included: Vision definition, outcome structure, NSM, design principles, strategic priorities Not included: Opportunity discovery (→ recipe-discover), persona definition (→ recipe-persona), reflection/distillation (→ recipe-reflect)
Completion
The workflow is complete when the confirmed vision and applicable design principles are written, or a no-change result is reported with any unresolved strategy decision.