executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
pivot-engineGenerates structured pivot options for a scored idea based on weak dimensions, market_insights signals, and founder constraints. Includes scoring simulation, minimum viable pivot criteria, effort estimation, and indie buildability filtering.
Independent GitHub snapshot · Automated classification · Original documentation governs
When an idea scores poorly in one or more dimensions, generate concrete pivot options rather than abandoning the idea entirely. A pivot is a deliberate change in one variable to improve the weakest dimension — not a complete restart. The best pivots preserve what's already strong while fixing what's broken, and they're grounded in real market signals, not wishful thinking.
memory/ideas/<slug>/scores.json (current scores — required)memory/ideas/<slug>/weaknesses.json (weak dimensions with root causes — required, run weakness-detection first)memory/ideas/<slug>/idea.md (current concept)memory/ideas/<slug>/competitors.json (positioning gaps, competitor complaints)memory/ideas/<slug>/distribution.json (current channel assessment)memory/ideas/<slug>/pricing.json (current pricing model and WTP)memory/ideas/<slug>/retention.json (current retention assessment)memory/user_profile.md (ICP tier, budget, time, distribution advantages)memory/market_insights/<niche>-*-<YYYY>-<MM>.md (trend data — use all available platform files)Market insights are essential for generating pivots grounded in real demand rather than theory. Extract:
| Field | How it informs pivots |
|---|---|
top_signals | Identify adjacent niches or audience segments with validated demand. A trending subreddit or TikTok hashtag near the idea's space suggests a viable audience pivot target. |
trend_velocity | If the current niche is "declining", pivoting within it is futile — pivot to an adjacent rising niche. If "rising-fast", the problem may be execution (distribution, pricing), not the market. |
monetization_evidence | If monetization is weak but market_insights show competitors successfully charging in the space, the issue is pricing model or positioning, not WTP. Pivot the model, not the idea. |
| Platform narratives (Reddit complaints, TikTok trends, App Store gaps) | Source specific pivot targets: underserved segments mentioned in Reddit threads, content angles trending on TikTok, App Store categories with stale top results. |
| Pivot type | What changes | What stays | When to use |
|---|---|---|---|
| Audience narrowing | Target user segment | Core problem and solution | Demand is broad but shallow; CAC too high because targeting is diffuse |
| Audience expansion | Broaden from niche to adjacent segment | Core solution mechanics | Market is too small (micro-niche verdict); SOM < $10K |
| Feature simplification | Scope and complexity | Core value proposition | Complexity too high; time-to-MVP exceeds founder capacity |
| Feature pivot | Core feature emphasis | Target audience and problem | Current feature set doesn't match what users actually want (review mining signals) |
| Niche pivot | Problem space subcategory | Solution approach | Competition too high in broad category; narrow to underserved niche |
| Pricing pivot | Pricing model or price point | Product and audience | WTP mismatch; wrong model for usage pattern; competitive pricing gap |
| Distribution pivot | Primary acquisition channel | Product and audience | Current channel is unviable; founder lacks skills/budget for assumed channel |
| Platform pivot | Target platform (iOS → web, mobile → desktop) | Core idea and audience | Wrong platform for audience behavior or market dynamics |
| Monetization pivot | Revenue model (B2C → B2C2B, app → content, product → service) | Core domain expertise | Direct monetization unviable but the domain has other revenue paths |
| Problem pivot | Which problem to solve | Target audience and domain | Audience is right but the specific pain point is weak; adjacent problem is stronger |
A pivot must be different enough to change the score but similar enough to preserve existing work and insights. Apply the Same Idea Test:
root_cause_type of "addressable" or "situational" in weaknesses.json. Pivots cannot fix structural weaknesses unless the pivot changes the core mechanic (which usually means it's a new idea).weaknesses.json. Identify all weak dimensions and their root causes.root_cause_type = "addressable" or "situational") → these are pivot targetsroot_cause_type = "knowledge-gap") → these need more research, not a pivotroot_cause_type = "structural") → only fixable by major pivot or new ideaoverall_weakness_severity = "fatal" and all weaknesses are structural, recommend dropping rather than pivoting. Note this in the output.Use this mapping to identify which pivot types are most likely to improve each weak dimension:
| Weak dimension | Primary pivot types | Secondary pivot types |
|---|---|---|
| Demand (< 40) | Problem pivot, audience narrowing | Niche pivot |
| Competition (< 40) | Niche pivot, audience narrowing | Feature pivot, platform pivot |
| Monetization (< 40) | Pricing pivot, monetization pivot | Audience narrowing (higher-WTP segment) |
| Distribution (< 40) | Distribution pivot, platform pivot | Audience narrowing (more reachable segment) |
| Retention (< 40) | Feature pivot, feature simplification | Problem pivot (pick a stickier problem) |
| Founder-Market Fit (< 40) | Niche pivot (toward founder's domain), feature simplification | Platform pivot (to founder's strongest platform) |
If multiple dimensions are weak, prioritize the one with the lowest score AND an addressable root cause.
For each applicable pivot type (from Step 2), generate a concrete option:
Pull evidence from market_insights:
competitors.jsonBe specific, not generic:
Generate 2–3 options, ranked by expected impact. Each option must pass the Minimum Viable Pivot Criteria.
For each pivot option, simulate the expected score change by projecting how each dimension would shift. This gives the orchestrator enough information to decide whether a full re-score is warranted.
For the dimension(s) the pivot targets, estimate the new score range based on:
idea-scoringFor dimensions the pivot doesn't target, assume they remain unchanged unless there's a clear secondary effect:
projected_score = sum of (projected_dimension_scores × weights) × projected_floor_penalty
Use the same weights and floor penalty logic from idea-scoring. This is an estimate — the actual re-score (step 4 of the pivot-optimization workflow) will be definitive.
Report as a range: projected_score_range: { low: X, high: Y }.
Each pivot has an execution cost. Estimate it relative to the founder's tier:
| Effort level | Definition | Typical timeline |
|---|---|---|
| Low | Can be done in a weekend. Changes copy, positioning, pricing, or targeting — no code changes. | 1–3 days |
| Medium | Requires feature changes or new content. Some development work. | 1–3 weeks |
| High | Significant rebuild. New core feature, new platform, or new audience requiring fresh research. | 1–3 months |
| Founder tier | Adjust |
|---|---|
| Beginner | Upgrade effort by one level (what's "medium" for a builder is "high" for a beginner) |
| Builder | No adjustment |
| Growth | Downgrade effort by one level (what's "medium" for a builder is "low" for growth) |
A pivot with "high" effort for the founder's tier should be flagged as risky — the time investment may not be justified unless the projected score improvement is substantial (≥ 20 points).
Before finalizing, verify each pivot option passes these constraints:
| Constraint | Fails if |
|---|---|
| Solo buildable | Pivot requires a team (e.g., marketplace requiring both supply and demand side simultaneously) |
| Budget feasible | Pivot requires spend exceeding founder's budget tier (e.g., "run paid social" for a Bootstrap founder) |
| Time feasible | Pivot requires > 3 months of work for the founder's tier |
| Skill feasible | Pivot requires skills the founder doesn't have and can't learn in 4 weeks (e.g., "build an ML model" for a no-code beginner) |
| No enterprise creep | Pivot moves the idea toward B2B enterprise, custom sales, or long sales cycles — fundamentally not an indie B2C play |
If a pivot fails any constraint, either modify it to fit or discard it and note why.
Rank remaining options by: (projected_score_improvement / effort_level) — the best pivot is the one with the highest score impact per unit of effort.
Tie-breakers:
Write two files to memory/ideas/<slug>/:
pivot_options.jsonMachine-readable structured data for downstream skills (idea-scoring, decision-memo):
{
"original_score": 0,
"original_verdict": "",
"triggered_by_weaknesses": [
{
"dimension": "",
"score": 0,
"root_cause_type": "",
"root_cause_description": ""
}
],
"structural_weaknesses_unpivotable": [],
"pivot_options": [
{
"pivot_id": "pivot-1",
"pivot_type": "",
"description": "",
"specific_change": "",
"evidence": "",
"evidence_source": "",
"meets_minimum_viable_pivot": true,
"scoring_simulation": {
"dimensions_improved": [
{ "dimension": "", "current": 0, "projected_low": 0, "projected_high": 0 }
],
"dimensions_worsened": [
{ "dimension": "", "current": 0, "projected_low": 0, "projected_high": 0 }
],
"dimensions_unchanged": [],
"projected_score_range": { "low": 0, "high": 0 },
"projected_verdict_range": ""
},
"effort": {
"level": "low | medium | high",
"tier_adjusted_level": "low | medium | high",
"timeline": "",
"what_changes": "",
"what_stays": ""
},
"indie_buildability": {
"passes": true,
"constraints_checked": ["solo_buildable", "budget_feasible", "time_feasible", "skill_feasible", "no_enterprise_creep"],
"failed_constraints": []
},
"trade_offs": [],
"variables_changed": 0
}
],
"recommended_pivot": "",
"recommended_pivot_rationale": "",
"drop_recommendation": false,
"drop_rationale": "",
"market_insights_sources_used": []
}
pivot_report.mdHuman-readable pivot brief. This is the document the founder actually reads. Write it after pivot_options.json is complete — source all data from the JSON, don't introduce new judgements.
---
idea_slug: <slug>
original_score: <X>
original_verdict: <verdict>
recommended_pivot: <pivot_id>
created_at: <YYYY-MM-DD>
---
# Pivot Report: <Idea Name>
## Why the Original Idea Scored <X>/100
<2–3 sentences. State the root cause of the low score plainly — not a list of every problem, just the one or two structural reasons the idea can't work as-is. Cite specific scores from scores.json (e.g. "Distribution scored 34/100 because…"). No hedging.>
---
## What Can Be Fixed vs. What Can't
**Addressable weaknesses** (pivot targets):
- <dimension>: <1-sentence root cause and why it's fixable>
- ...
**Structural weaknesses** (cannot be pivoted away):
- <dimension>: <1-sentence root cause and why no pivot can fix it>
- ...
<If all weaknesses are structural, state clearly that a pivot is unlikely to rescue this idea and explain why.>
---
## Pivot Options
### Option 1 — <Pivot Type>: <Short Name> · Projected score: <low>–<high>/100 · Effort: <tier_adjusted_level>
**The change:** <1–2 sentences. Be specific about exactly what changes — audience, feature, channel, pricing model, platform. Name concrete details (specific subreddits, competitor pricing, App Store keywords, etc.).>
**Why this works:** <2–3 sentences grounded in evidence. Cite the market_insights signal, competitor gap, or user complaint that supports this direction. Name the source (e.g. "r/FigmaDesign has 150K active members discussing invoice pain", "BookPal's 1-star reviews consistently mention X", "TikTok hashtag #X has 40M views and rising velocity").>
**What stays the same:** <1 sentence. What existing work and strengths are preserved.>
**Score projection:**
| Dimension | Current | Projected |
|---|---|---|
| <dimension> | <current>/100 | <low>–<high>/100 |
| <dimension (worsened)> | <current>/100 | <low>–<high>/100 |
| ... | ... | unchanged |
**Trade-offs:** <1–2 sentences. What this pivot gives up. Be honest — every pivot has a cost.>
**Effort:** <What specifically needs to change — code, copy, positioning, research. Timeline.>
---
### Option 2 — <Pivot Type>: <Short Name> · Projected score: <low>–<high>/100 · Effort: <tier_adjusted_level>
<Same structure as Option 1.>
---
### Option 3 — <Pivot Type>: <Short Name> · Projected score: <low>–<high>/100 · Effort: <tier_adjusted_level> *(optional)*
<Same structure as Option 1. Include only if a genuinely distinct third option exists.>
---
## Recommendation
**Go with Option <N> — <Short Name>.**
<3–4 sentences. State why this option has the best impact-to-effort ratio. Reference the scoring simulation. Name the one thing that makes this pivot more credible than the alternatives (the market signal, the competitor gap, the distribution advantage). End with a specific first action the founder should take this week.>
**If this pivot also scores below 50:** <1 sentence — what that means and what to do (drop, major rethink, or new idea slug).>
---
## What to Do First
<1–3 concrete steps, ordered. Each step should be doable within a week. No vague advice — name the specific subreddit, pricing change, App Store keyword, or feature to cut. If a RAT experiment makes sense before committing to the pivot, define it here: ≤2 weeks, ≤$100, pass/fail criteria.>
pivot_report.md62–71/100 is honest. 67/100 implies certainty the model doesn't have.overall_weakness_severity = "fatal" and all weaknesses are structural, set drop_recommendation = true and explain why no pivot can save this idea. Still generate 1 option as a "Hail Mary" if the founder wants to try, but be honest about the odds.competitors.json for positioning_gaps — an identified gap with evidence is the strongest pivot foundation.pivot_id field is used by idea-scoring to link re-scores in pivot_scores.json back to the specific option.stale_after date, note that pivot evidence may be outdated and recommend refreshing trend analysis before committing to a pivot direction.