Skip to main content
skill CX Codex

develop-solution-brief — Claude Code skill: one-page solution brief

Turns a problem into a one-page brief: proposed approach, key features, trade-offs and risks. Useful before you write the full spec.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-code
Open on GitHub

What develop-solution-brief does

The skill walks the agent through seven steps: recap the problem, describe the proposed solution in plain language, list key features, define success metrics, state trade-offs, cover risks with mitigations, and outline next steps. Output follows the template in references/TEMPLATE.md, with every section filled in. A finished example sits in references/EXAMPLE.md.

The one-page limit is the point. Roughly 500–700 words, 3–5 essential features, a problem recap of 2–3 sentences. That constraint is what makes the brief readable for stakeholders who don't want implementation detail.

Pick something else when the approach is already settled. If engineering needs the full specification, use deliver-prd — the brief pitches, the PRD specifies. If the problem itself isn't framed yet, run define-problem-statement first. For a decision already made, the author points to develop-adr or develop-design-rationale. The skill is Apache-2.0, sits in the develop phase and the ideation category, and draws on triple-diamond, lean-startup and design-thinking.

What it helps with

  • fit a solution description onto a single page
  • align teams on an approach before PRD writing
  • record what you deliberately left out of scope
  • show leadership the main risks and how you'll handle them
  • compare several solution options at a high level

Example prompts for the agent

  • write a solution brief for our onboarding problem
  • draft a one-page brief: problem, solution, trade-offs, risks
  • prepare a solution brief to pitch the approach to stakeholders

How to install develop-solution-brief

1Skills CLI (Vercel)

npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-code

2Manually: put the files in place

~/.claude/skills/develop-solution-brief/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/develop-solution-brief/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about develop-solution-brief

How do I install develop-solution-brief in Claude?

Run npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-code. The skill file lands at ~/.claude/skills/develop-solution-brief/SKILL.md.

What does develop-solution-brief do?

It produces a one-page document covering the proposed solution: a short problem recap, key features, success metrics, trade-offs considered, risks with mitigations, and next steps.

How is it different from a PRD?

The brief pitches the approach and stays on one page; the spec comes from a separate skill, deliver-prd. If stakeholders already agree and engineers need detail, go with the PRD.

Source text

SKILL.md · Apache-2.0
---
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 -->
# Solution Brief

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 to Use

- Pitching a solution approach to stakeholders for buy-in
- Aligning cross-functional teams on what you're building and why
- Documenting solution intent before detailed PRD writing
- Comparing multiple solution options at a high level
- Communicating product direction to leadership

## When NOT to Use

- Stakeholders are aligned and engineering needs the full specification -> use `deliver-prd`; the brief pitches, the PRD specifies
- The problem is not yet framed or agreed -> use `define-problem-statement` first
- You are recording a decision already made -> use `develop-adr` (technical) or `develop-design-rationale` (design)
- You need to compare strategic options across the whole business model -> use `foundation-lean-canvas`

## Instructions

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.

## Output Format

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.

## Quality Checklist

Before finalizing, verify:

- [ ] Brief fits on one page when printed (approximately 500-700 words)
- [ ] Problem recap is concise (2-3 sentences maximum)
- [ ] Solution description avoids technical jargon
- [ ] Features are limited to 3-5 essential capabilities
- [ ] Trade-offs are explicitly stated
- [ ] Next steps are specific and actionable

## Examples

See `references/EXAMPLE.md` for a completed example.

© product-on-purpose · Apache-2.0 · product-on-purpose/pm-skills

Similar skills

Everything for Notes, tasks and projects →

From the same set68

define-hypothesis Turns an assumption about user behavior into a falsifiable statement with success metrics and a validation plan, before you design any experiment. CX Codex +1 806installs develop-adr A skill that writes Architecture Decision Records: the context, the choice, and what it costs you later. Useful when the team picks a database, framework or pattern. CX Codex +1 792installs deliver-launch-checklist Builds a cross-functional pre-launch checklist: engineering, design, marketing, support, legal, operations. For launches that span several teams. CX Codex +1 786installs define-opportunity-tree Turns a measurable outcome into a tree of customer opportunities, candidate solutions and assumption tests. Useful when feature ideas pile up without structure. CX Codex +1 774installs discover-interview-synthesis This skill turns interview notes and transcripts into themes, quotes, insights and recommendations. Useful after a round of user research when the team needs to see what you heard. CX Codex +1 770installs define-jtbd-canvas This skill builds a Jobs to be Done canvas covering the functional, emotional and social sides of a customer job. Useful when you need to understand motivation before building. CX Codex +1 770installs measure-dashboard-requirements Defines dashboard requirements by focusing on business questions, metric formulas, filters, and data sources. Useful when requesting reporting from analytics teams. CX Codex +1 756installs measure-experiment-design Produces an experiment design doc with variants, metrics, sample size and duration. Useful once the hypothesis is written and the test has not started yet. CX Codex +1 754installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor