define-hypothesis
Defines a testable hypothesis with clear success metrics and a validation approach. Use when…
Creates a concise one-page solution overview that communicates the proposed approach, key decisions, and trade-offs. Use when pitching solutions to stakeholders, aligning teams on approach, or documenting solution intent before detailed specification.
$ npx -y skills add product-on-purpose/pm-skills --skill develop-solution-brief --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/develop-solution-briefContext preview
The summary Claude sees to decide when to auto-load this skill.
Creates a concise one-page solution overview that communicates the proposed approach, key decisions, and trade-offs. Use when pitching solutions to stakeholders, aligning teams on approach, or documenting solution intent before detailed specification.
name: develop-solution-brief description: Creates a concise one-page solution overview that communicates the proposed approach, key decisions, and trade-offs. Use when pitching solutions to stakeholders, aligning teams on approach, or documenting solution intent before detailed specification. license: Apache-2.0 metadata: phase: develop version: "2.1.0" updated: 2026-06-10 category: ideation frameworks: [triple-diamond, lean-startup, design-thinking] author: product-on-purpose
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->
A solution brief is a concise, one-page document that communicates the proposed solution to a problem. It serves as the bridge between problem understanding and detailed specification, providing enough context for stakeholders to align on the approach without getting lost in implementation details. The one-page constraint forces clarity and prioritization.
When asked to create a solution brief, follow these steps:
1. **Recap the Problem** Summarize the problem in 2-3 sentences maximum. Don't re-explain the full problem statement - reference it if needed. The reader should immediately understand what pain point this solution addresses.
2. **Describe the Proposed Solution** Explain what you're building in clear, non-technical language. Focus on the user experience and core value proposition. Avoid implementation details - this is about *what*, not *how*.
3. **List Key Features** Identify 3-5 essential features that comprise the solution. These should be the minimum set needed to solve the problem. Resist the urge to include nice-to-haves - the one-page constraint demands focus.
4. **Define Success Metrics** Connect the solution to measurable outcomes. How will you know if this works? Reference metrics from the problem statement and set targets.
5. **Acknowledge Trade-offs** Document what you're explicitly NOT doing and why. Good solution briefs are honest about scope limitations and alternatives that were considered but rejected.
6. **Identify Risks and Mitigations** Surface the biggest risks to success and your plan to address them. This builds stakeholder confidence and surfaces concerns early.
7. **Outline Next Steps** Provide 3-5 immediate actions to move the solution forward. Be specific about who does what.
Use the template in `references/TEMPLATE.md` to structure the output. A complete brief fills every template section: Problem Recap; Proposed Solution; Key Features; Success Metrics; Trade-offs Considered; Risks & Mitigations; and Next Steps.
Before finalizing, verify:
See `references/EXAMPLE.md` for a completed example.
68 plug-and-play, best-practice product management skills for AI agents: 30 Triple Diamond phase + 11 foundation + 12 utility + 15 tool (Foundation Sprint + Design Sprint). Plus 6 sub-agents, workflows, 200+ output samples, guides, and CI-enforced contracts. Apache 2.0.
Repo: product-on-purpose/pm-skills
Defines a testable hypothesis with clear success metrics and a validation approach. Use when…
Creates a Jobs to be Done canvas capturing the functional, emotional, and social dimensions…
Creates an opportunity solution tree connecting a desired outcome to customer opportunities…
Run applicable prioritization frameworks (RICE, ICE, MoSCoW, Weighted Scoring, Kano) against…
Creates a clear problem framing document with user impact, business context, and success…
Generates structured Given/When/Then acceptance criteria for a user story or feature slice,…