Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add product-on-purpose/pm-skills --skill iterate-pivot-decision -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/iterate-pivot-decision/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/iterate-pivot-decision/

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

Similar skills

Everything for Notes, tasks and projects →

From the same set68

utility-mermaid-diagrams Guides product managers in building valid Mermaid diagrams across 15 supported formats for PRDs and technical specs. CX Codex +1 736installs discover-stakeholder-summary A skill that builds a stakeholder map for a project: who has influence, what they need, what worries them, and how to engage them. CX Codex +1 734installs foundation-okr-writer Drafts, audits, and coaches outcome-focused OKR sets across company, product, or team levels. It turns task roadmaps into verifiable metrics. CX Codex +1 727installs develop-spike-summary Documents the results of a completed technical or design spike. It captures findings, evidence, and a clear recommendation so the team avoids re-litigating decisions. CX Codex +1 726installs iterate-lessons-log Writes a structured lessons learned entry after an incident or a finished project. Useful when the knowledge has to outlive the team that earned it. CX Codex +1 721installs utility-slideshow-creator Generates .pptx and .pdf presentations from a JSON deck spec using 18 predefined slide layouts. Useful for stakeholder updates and product reviews without manual slide formatting. CX Codex +1 719installs foundation-lean-canvas Fills a nine-block lean canvas on a single page and tags every block with a confidence level. Useful when you want to stress-test a product thesis before writing code. CX Codex +1 717installs iterate-refinement-notes Writes up backlog refinement outcomes: stories refined, estimates, open questions and decisions. Useful when part of the team missed the session. CX Codex +1 707installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor