develop-solution-brief — скилл для Claude Code: одностраничный бриф
Собирает одностраничный бриф: что за проблема, что предлагаете, какие компромиссы и риски. Пригодится перед написанием подробной спецификации.
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-codeЧто делает develop-solution-brief
Скилл ведёт агента по семи шагам: коротко напомнить проблему, описать предлагаемое решение простым языком, перечислить ключевые функции, задать метрики успеха, назвать компромиссы, риски с мерами и следующие шаги. На выходе — документ по шаблону из references/TEMPLATE.md, заполненный по всем разделам. Готовый пример лежит в references/EXAMPLE.md.
Главное ограничение зашито в сам формат: бриф должен умещаться на одну страницу, примерно 500–700 слов. Поэтому функций в списке не больше 3–5, а напоминание о проблеме — 2–3 предложения. Если нужно полное описание требований, этот скилл не подойдёт: он питчит подход, а спецификацию пишет deliver-prd. Для ещё не согласованной проблемы сначала идите в define-problem-statement.
Автор относит скилл к фазе develop, категории ideation и опирается на triple-diamond, lean-startup и design-thinking. Лицензия Apache-2.0. Ничего доустанавливать не нужно — это текстовый файл с инструкциями и шаблонами.
Какие задачи решает
- уложить описание решения на одну страницу
- согласовать подход между командами до написания PRD
- зафиксировать, что сознательно не делаем и почему
- показать руководству риски и меры по ним
- сравнить несколько вариантов решения на верхнем уровне
Примеры запросов агенту
- собери solution brief по нашей проблеме с онбордингом
- сделай одностраничный бриф: проблема, решение, компромиссы, риски
- подготовь solution brief для защиты подхода перед стейкхолдерами
Как установить develop-solution-brief
1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-code2Вручную: положить файлы
~/.claude/skills/develop-solution-brief/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/develop-solution-brief/
1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a codex2Вручную: положить файлы
.agents/skills/develop-solution-brief/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a cursor2Вручную: положить файлы
.cursor/skills/develop-solution-brief/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install product-on-purpose/pm-skills develop-solution-brief2Вручную: положить файлы
.github/skills/develop-solution-brief/SKILL.md1Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a gemini-cli2Командой платформы
gemini skills install https://github.com/product-on-purpose/pm-skills --path skills/develop-solution-briefВручную: положить файлы
.devin/skills/develop-solution-brief/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о develop-solution-brief
Как установить develop-solution-brief в Claude?
Выполните npx skills add product-on-purpose/pm-skills --skill develop-solution-brief -a claude-code. После этого файл скилла окажется в ~/.claude/skills/develop-solution-brief/SKILL.md.
Что делает develop-solution-brief?
Создаёт одностраничный документ с предлагаемым решением: краткий пересказ проблемы, ключевые функции, метрики успеха, компромиссы, риски и следующие шаги.
Чем бриф отличается от PRD?
Бриф питчит подход и умещается на странице, а спецификацию пишет отдельный скилл deliver-prd. Если команда уже согласна с решением и инженерам нужны детали, берите PRD.
Исходный текст
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