iterate-pivot-decision — Claude Code skill: what it does
Documents a strategic pivot or persevere choice using market feedback and data. Useful after an MVP launch or when original product hypotheses fail.
npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a claude-codeWhat iterate-pivot-decision does
This skill structures the choice to stay the course or change direction using the Lean Startup pivot-or-persevere framework. It replaces unstructured team debates with an evidence-grounded document. The output records hypothesis validation and evaluates concrete paths forward alongside an execution plan.
The workflow follows seven distinct steps. The agent compiles user feedback, checks which initial hypotheses failed, and frames at least three options: persevering plus two distinct pivot directions. It evaluates each option against market upside and team capability. If stakeholders disagree on the outcome, the draft explicitly records dissenting opinions.
Do not run this skill before shipping anything. Evaluating untested concepts before writing code belongs in foundation-build-risk-review. This tool requires actual market evidence from a live product or feature.
What it helps with
- document a pivot or persevere choice after an MVP launch
- evaluate invalidated product hypotheses against market signals
- compare distinct pivot options by risks and resource needs
- draft an implementation and communication plan for a strategic shift
Example prompts for the agent
- Draft a pivot decision document based on user retention data from our MVP launch.
- Evaluate whether to persevere or pivot, comparing two alternative product directions.
How to install iterate-pivot-decision
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a claude-code2Manually: put the files in place
~/.claude/skills/iterate-pivot-decision/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/iterate-pivot-decision/
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a codex2Manually: put the files in place
.agents/skills/iterate-pivot-decision/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a cursor2Manually: put the files in place
.cursor/skills/iterate-pivot-decision/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install product-on-purpose/pm-skills iterate-pivot-decision2Manually: put the files in place
.github/skills/iterate-pivot-decision/SKILL.md1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a gemini-cli2Platform CLI
gemini skills install https://github.com/product-on-purpose/pm-skills --path skills/iterate-pivot-decisionManually: put the files in place
.devin/skills/iterate-pivot-decision/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about iterate-pivot-decision
How do I install iterate-pivot-decision in Claude Code?
Run the following command in your terminal: npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a claude-code.
What does iterate-pivot-decision do?
It guides the agent through a seven-step sequence to assess invested resources, verify hypotheses, evaluate three distinct courses of action, and document the final decision with execution steps.
When should I not use this skill?
Do not use it if the product has not shipped yet; use foundation-build-risk-review instead. If you only need a standard team ceremony without changing direction, use iterate-retrospective.
Source text
SKILL.md · Apache-2.0
--- name: iterate-pivot-decision description: Documents a strategic pivot or persevere decision with the evidence, analysis, and rationale. Use when evaluating whether to change direction on a product, feature, or strategy based on market feedback. license: Apache-2.0 metadata: phase: iterate version: "2.1.1" updated: 2026-06-22 category: reflection frameworks: [triple-diamond, lean-startup, design-thinking] author: product-on-purpose --- <!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 --> # Pivot Decision A pivot decision document captures the analysis and rationale behind a strategic direction change.or the decision to stay the course. Based on the Lean Startup concept of "pivot or persevere," this artifact ensures major strategic decisions are made with evidence, communicated clearly, and preserved for organizational learning. ## When to Use - After significant validated learning suggests the current direction may not work - At planned pivot-or-persevere checkpoints (e.g., after MVP launch) - When key hypotheses have been invalidated by market feedback - During strategy reviews when considering major direction changes - When stakeholders are debating whether to change course ## When NOT to Use - You are reporting experiment results without a direction decision attached -> use `measure-experiment-results` - The decision is technical or architectural rather than directional -> use `develop-adr` - You want to explore candidate directions before deciding anything -> use `define-opportunity-tree` - The team needs the period-end reflection ceremony -> use `iterate-retrospective`; a pivot call is a decision document, not a retro - The product is not built yet, and the question is whether to build a new idea, feature, or scope change at all (a build / validate / cut verdict) -> use `foundation-build-risk-review`; a pivot call weighs market feedback on something already shipped ## Instructions When asked to document a pivot decision, follow these steps: 1. **Summarize Current State** Document what you're currently doing, how long you've been doing it, what you've invested, and what results you've achieved. This grounds the decision in reality. 2. **Present the Evidence** Compile all relevant data: metrics, user feedback, experiment results, market signals. Be comprehensive.include evidence that supports both staying and changing course. 3. **Review Hypotheses** Revisit the original hypotheses that justified the current direction. Which have been validated? Which have been invalidated? Which remain untested? 4. **Define Options** Articulate at least three options: persevere (continue current direction), and two or more distinct pivot options. Describe each option concretely.what would change? 5. **Analyze Each Option** Evaluate options against key criteria: market opportunity, competitive advantage, team capability, resource requirements, and risk. Use evidence, not opinions. 6. **Make the Decision** State the chosen direction clearly. Explain the rationale, acknowledging trade-offs. If the team disagrees, capture dissenting views. 7. **Plan Implementation** Outline what happens next: immediate actions, resource needs, success criteria for the new direction, and communication plan. ## Output Format Use the template in `references/TEMPLATE.md` to structure the output. A complete decision document fills every template section: Overview; Executive Summary; Current State; Evidence Summary; Hypothesis Review; Options Considered; Analysis; Decision; Implementation Plan; Communication Plan; and Appendix. ## Quality Checklist Before finalizing, verify: - [ ] Current state includes honest assessment of results - [ ] Evidence is comprehensive, not cherry-picked - [ ] Multiple options are analyzed fairly - [ ] Decision rationale is clear and evidence-based - [ ] Implementation plan is actionable - [ ] Dissenting views are captured ## Examples See `references/EXAMPLE.md` for a completed example.
© product-on-purpose · Apache-2.0 · product-on-purpose/pm-skills