Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
product-on-purpose avatar

Iterate Pivot Decision

  • 488 installs
  • 518 repo stars
  • Updated August 4, 2026
  • product-on-purpose/pm-skills

iterate-pivot-decision is an agent skill that documents pivot-or-persevere decisions with evidence, hypothesis review, and implementation plans for developers and PMs evaluating whether to change product direction after

About

iterate-pivot-decision is a product-on-purpose/pm-skills agent skill (version 2.1.1) that captures the analysis and rationale behind a strategic direction change or a decision to stay the course, based on Lean Startup pivot-or-persevere thinking. The skill walks through seven steps: summarize current state and investment, compile metrics and user feedback, revisit original hypotheses, define at least three options (persevere plus distinct pivots), analyze each against market opportunity and risk, state the chosen direction with dissenting views, and plan implementation with communication steps. Output follows references/TEMPLATE.md with eleven sections including Overview, Executive Summary, Evidence Summary, Options Considered, Decision, and Implementation Plan. Use it after MVP launch, invalidated hypotheses, or strategy reviews—not for experiment-only reports or pre-build scope decisions.

  • iterate-pivot-decision
  • AI & Agent Building
  • AI-coding skill

Iterate Pivot Decision by the numbers

  • 488 all-time installs (skills.sh)
  • +30 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #1,796 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/product-on-purpose/pm-skills --skill iterate-pivot-decision

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs488
repo stars518
Last updatedAugust 4, 2026
Repositoryproduct-on-purpose/pm-skills

How do you document a product pivot decision with evidence?

Helps with ai & agent building tasks.

Who is it for?

Product managers and tech leads at pivot-or-persevere checkpoints who need an evidence-backed decision record after significant validated learning from a shipped product.

Skip if: Teams reporting experiment results without a direction decision, making purely technical architecture choices, or deciding whether to build an unshipped idea at all.

When should I use this skill?

Market feedback or metrics suggest the current product direction may not work and stakeholders need a structured pivot-or-persevere decision document.

What you get

Completed pivot decision document with evidence summary, hypothesis review, options analysis, chosen direction rationale, implementation plan, and communication plan.

  • Pivot decision document
  • Implementation and communication plans

By the numbers

  • Version 2.1.1 documented in skill frontmatter
  • Output template includes eleven required document sections
  • Workflow defines at least three strategic options before deciding

Files

SKILL.mdMarkdownGitHub ↗

<!-- 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.

Related skills

How it compares

Use iterate-pivot-decision for direction-change decisions after shipping; use measure-experiment-results when you only need to report experiment outcomes without a pivot call.

FAQ

What artifact does iterate-pivot-decision produce?

iterate-pivot-decision produces a pivot decision document with eleven sections—Overview, Executive Summary, Current State, Evidence Summary, Hypothesis Review, Options Considered, Analysis, Decision, Implementation Plan, Communication Plan, and Appendix—following the repo TEMPLAT

When should teams use iterate-pivot-decision?

Teams should use iterate-pivot-decision after significant validated learning, MVP launch checkpoints, or invalidated hypotheses when debating a major direction change—not for experiment-only reports or pre-build scope reviews.

How many strategic options must iterate-pivot-decision analyze?

iterate-pivot-decision requires at least three options: persevere on the current direction plus two or more distinct pivot alternatives, each evaluated against market opportunity, team capability, resources, and risk.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.