
tool-foundation-sprint-magic-lenses
Day 2 afternoon move of a Foundation Sprint. Evaluates the candidate approach set through multiple lenses (4 classic plus at least 1 custom) to surface trade-offs, identify consistent winners and contradictions, and produce a top bet plus a backup plan. Use after Approach Options is signed. Lens scoring is a sense-making tool, not mathematical truth; arbitrary precision is a smell.
- Installs
- 625
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/product-on-purpose/pm-skills --skill tool-foundation-sprint-magic-lenses- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads tool-foundation-sprint-magic-lenses automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Foundation Sprint Magic Lenses
Day 2 afternoon of a Foundation Sprint. The team evaluates each candidate approach from multiple perspectives, surfaces contradictions, and produces a top bet plus a backup plan. The Decider names both; without an explicit backup, invalidation of the top bet sends the team back to ambiguous debate.
Family contract: docs/reference/skill-families/foundation-sprint-skills-contract.md. This skill is a member of foundation-sprint-skills.
When to Use
- Day 2 afternoon of a Foundation Sprint.
- Approach Options is signed; the team has 3-7 candidate approaches advancing.
- The team has at least 1 team-specific custom lens prepared (per ratified spec decision; classic lenses alone are insufficient).
When NOT to Use
- Approach Options is unresolved or under-numbered (fewer than 3). Force a third option through the approach-options skill first.
- The team has pre-committed to a top bet. Magic Lenses is a sense-making exercise; if the decision is already made, the time is better spent on Founding Hypothesis.
- The team is exhausted and cannot evaluate clearly. Postpone to Day 2 morning of a follow-up sprint rather than rush.
What This Skill Produces
A single bundled artifact with six sections:
- Classic lens charts: customer, pragmatic, growth, money lenses each as a 2x2 plot or qualitative position of every approach.
- Custom lens charts: at least 1 team-specific lens (defensibility, mission fit, founder excitement, learning rate, etc.).
- Pattern review: consistent winners across lenses, contradictions, biggest trade-off the team is making.
- Top bet: the Decider's chosen approach with rationale.
- Backup plan: the runner-up approach the team falls back to if the top bet invalidates.
- Decision rationale: one paragraph explaining why the top bet over the backup.
See references/TEMPLATE.md for the canonical structure and references/EXAMPLE.md for the Brainshelf example.
The Five Canonical Lenses
| Lens | What it asks | Why it matters |
|---|---|---|
| Customer | Which approach do target customers immediately understand and want? | If customers don't get it, nothing else matters |
| Pragmatic | Which approach can the team ship at quality in [build window]? | Beautiful approaches the team can't ship are not real options |
| Growth | Which approach gives the team a story strong enough to acquire users without paid channels? | Friction at the door tells you about word-of-mouth potential |
| Money | Which approach has the cleanest path to a paying customer? | Strategic clarity must include the revenue path |
| Custom (1+ required) | Team-specific lens that captures what would otherwise be missed | Each team has a unique constraint or opportunity worth a dedicated view |
Custom lens examples: defensibility against a specific competitor, founder excitement, mission fit, learning rate, regulatory risk, partner alignment, hiring leverage.
Sequence (105 minutes)
Step 1: Frame the lenses (5 min)
Facilitator restates the 4 classic lenses and confirms the 1 or more custom lenses the team prepared. If no custom lens is prepared, this skill prompts the team to generate one before proceeding (per ratified spec decision).
Step 2: Score each approach per lens (40-60 min)
For each lens, plot each approach on a 2x2 of (high/low value on that lens) by (high/low feasibility for that lens). Use dot positions rather than numeric scores; arbitrary precision (3.7 vs 3.8) is a smell that the team has confused sense-making with math.
The team discusses each lens briefly before plotting. Decider does not vote in this step; the Decider supervotes at the end.
Step 3: Pattern review (15-25 min)
After all lenses are plotted, the team identifies:
- Consistent winners: approaches that score in the top half of 3 or more lenses.
- Consistent losers: approaches that score in the bottom half of 3 or more lenses. These drop out.
- Contradictions: approaches that win one lens hard but lose another. These surface the trade-offs the Decider must make.
- Biggest trade-off: name it explicitly. "Boring-and-shippable vs risky-and-distinctive." "Mass-market vs niche-defensible." Naming the trade-off prevents the Decider from picking by vibes.
Step 4: Decider supervote on top bet (10-15 min)
The Decider names the top bet. The chosen approach should be:
- A consistent winner OR a contradictory approach the Decider explicitly chooses to take the bet on.
- Defensible in language ("we are betting [trade-off] because [reason]").
- Aligned with the Mini Manifesto from Day 1.
Step 5: Decider names backup plan (5-10 min)
The Decider names the backup. The backup is NOT a second-place approach to soothe whoever advocated for it; it is the approach the team will pivot to if the top bet fails validation. The backup MUST be distinct from the top bet in strategic direction.
If the top bet and backup are too similar, the Decider has not named a real backup. The skill prompts for a more distinct alternative.
Step 6: Decision rationale (5-10 min)
The Decider authors one paragraph explaining why this top bet over this backup. The rationale will become the spine of the Founding Hypothesis's "why we believe this" section.
Common Pitfalls
- Treating lens scoring as mathematical truth. Lenses are sense-making tools; if the team argues about whether an approach scores 3.7 or 3.8 on a lens, the team has lost the plot.
- Skipping the custom lens. The 4 classic lenses are generic by design. The custom lens is where the team's specific situation shows up; skipping it produces a generic top bet.
- Falling in love with the top bet. Confidence after Magic Lenses should be calibrated, not high. The next skill, Founding Hypothesis, asks "what could prove us wrong"; the team that has fallen in love with the top bet cannot answer that question honestly.
- Skipping the backup plan. Without an explicit backup, invalidation sends the team back to ambiguous debate. The backup forces the team to acknowledge that the top bet might fail.
- Backup that is too similar to top bet. "Approach Yellow with one feature added" is not a backup; it's an iteration. Backup must be a different strategic direction.
- Decider names top bet by enthusiasm, not by analysis. The pattern review exists to give the Decider a structured basis for the call. If the Decider picks before the pattern review, the skill provided no value.
Decider Role
The Decider's job during Magic Lenses:
- Listen during lens scoring without telegraphing preferences.
- Engage during pattern review to surface the trade-off explicitly.
- Supervote the top bet with rationale.
- Name the backup plan as a distinct strategic direction.
- Author the one-paragraph decision rationale.
Canonical Sources
- Character Capital. "Foundation Sprint guide." Magic Lenses section and lens definitions.
- Knapp, J., and Zeratsky, J. Click. Day 2 afternoon sequence.
- Knapp, J., and Zeratsky, J. "Introducing the Foundation Sprint." Lenny's Newsletter. Magic Lenses section.
Cross-Skill Usage
Prerequisites: tool-foundation-sprint-approach-options. The approach set is the load-bearing input.
The skill invokes tool-note-and-vote at least once (for the top bet supervote when scoring is ambiguous). Additional invocations may happen for the custom lens definition if the team has not pre-prepared one.
Next invocation: tool-foundation-sprint-founding-hypothesis at Day 2 end. The top bet, the backup, and the decision rationale flow directly into the Founding Hypothesis template.
Decider Checkpoint
This skill ends with a Decider Checkpoint in references/TEMPLATE.md. The Decider signs off on the top bet, the backup, and the decision rationale. Without sign-off, Founding Hypothesis cannot start cleanly.
FAQ
What does the tool-foundation-sprint-magic-lenses skill do?
Day 2 afternoon move of a Foundation Sprint. Evaluates the candidate approach set through multiple lenses (4 classic plus at least 1 custom) to surface trade-offs, identify consistent winners and contradictions, and produce a top bet plus a backup plan. Use after Approach Options is signed. Lens scoring is a sense-making tool, not mathematical truth; arbitrary precision is a smell.
How do I install tool-foundation-sprint-magic-lenses?
Run npx skills add https://github.com/product-on-purpose/pm-skills --skill tool-foundation-sprint-magic-lenses in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tool-foundation-sprint-magic-lenses/ (personal) or .claude/skills/tool-foundation-sprint-magic-lenses/ (project).
Which AI agents can use tool-foundation-sprint-magic-lenses?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is tool-foundation-sprint-magic-lenses safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains tool-foundation-sprint-magic-lenses?
It is published by product-on-purpose in product-on-purpose/pm-skills. It has 625 recorded installs.
More from product-on-purpose/pm-skills
deliver-acceptance-criteria
product-on-purpose/pm-skills
Generates structured Given/When/Then acceptance criteria for a user story or feature slice, covering the happy path, key failure scenarios, and non-functional expectations in testable form. Use when turning requirements into verifiable scenarios for engineering handoff and QA sign-off. For a dedicated catalog of boundary conditions, error states, and recovery paths across a feature, use deliver-edge-cases; to write the stories themselves, use deliver-user-stories.
deliver-prd
product-on-purpose/pm-skills
Creates a comprehensive Product Requirements Document that aligns stakeholders on what to build, why, and how success will be measured. Use when specifying features, epics, or product initiatives for engineering handoff.
deliver-user-stories
product-on-purpose/pm-skills
Generates user stories in the standard persona, action, benefit story format from product requirements or feature descriptions. Use when breaking a feature into stories for sprint planning, writing tickets, or communicating scope to engineering. For testable Given/When/Then acceptance criteria on a story, use deliver-acceptance-criteria; for boundary and failure scenarios, use deliver-edge-cases.
deliver-edge-cases
product-on-purpose/pm-skills
Documents edge cases, error states, boundary conditions, race conditions, and recovery paths for a feature - the systematic catalog of what can go wrong and the failure modes to design for. Use during specification to map the failure surface and ensure comprehensive coverage, or during QA planning to identify boundary and limit scenarios to test. Distinct from deliver-acceptance-criteria, which writes story-level Given/When/Then checks; this skill produces the whole-feature edge-case catalog.
discover-competitive-analysis
product-on-purpose/pm-skills
Creates a structured competitive analysis comparing features, pricing, and positioning across 3-5 direct and indirect competitors, with a 2x2 map and actionable strategic recommendations. Use before entering a market, planning differentiation, or after losing deals. For market size rather than competitor positioning, use discover-market-sizing instead.
define-problem-statement
product-on-purpose/pm-skills
Creates a clear problem framing document with user impact, business context, and success criteria. Use when starting a new initiative, realigning a drifted project, or communicating up to leadership.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.