product-on-purpose/develop-solution-brief
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 skills add https://github.com/product-on-purpose/pm-skills --skill develop-solution-brief
<!-- 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.
deliver-prd; the brief pitches, the PRD specifiesdefine-problem-statement firstdevelop-adr (technical) or develop-design-rationale (design)foundation-lean-canvasWhen asked to create a solution brief, follow these steps:
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.
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*.
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.
Connect the solution to measurable outcomes. How will you know if this works? Reference metrics from the problem statement and set targets.
Document what you're explicitly NOT doing and why. Good solution briefs are honest about scope limitations and alternatives that were considered but rejected.
Surface the biggest risks to success and your plan to address them. This builds stakeholder confidence and surfaces concerns early.
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.
Take product-on-purpose/develop-solution-brief from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.