develop-solution-brief
Skill777 starsChanged 10 months agoApache-2.0View on GitHub
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.
1 other project uses a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- yuusakuri/agent-skillsedited, first seen Nov 1, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 1
- yuusakuri/agent-skills★ 298% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository69 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- define-hypothesisSkill
- define-jtbd-canvasSkill
- define-opportunity-treeSkill
- define-prioritization-frameworkSkill
- define-problem-statementSkill
- deliver-acceptance-criteriaSkill
- deliver-edge-casesSkill
- deliver-launch-checklistSkill
- deliver-prdSkill
- deliver-release-notesSkill
- deliver-user-storiesSkill
- develop-adrSkill
- develop-design-rationaleSkill
- develop-spike-summarySkill
- discover-competitive-analysisSkill
- discover-interview-synthesisSkill
- discover-journey-mapSkill
- discover-market-sizingSkill
- discover-stakeholder-summarySkill
- foundation-build-risk-reviewSkill
- foundation-lean-canvasSkill
- foundation-meeting-agendaSkill
- foundation-meeting-briefSkill
- foundation-meeting-recapSkill
- foundation-meeting-synthesizeSkill
- foundation-okr-writerSkill
- foundation-personaSkill
- foundation-prioritized-action-planSkill
- foundation-stakeholder-briefingsSkill
- foundation-stakeholder-updateSkill
- iterate-lessons-logSkill
- iterate-pivot-decisionSkill
- iterate-refinement-notesSkill
- iterate-retrospectiveSkill
- measure-dashboard-requirementsSkill
- measure-experiment-designSkill
- measure-experiment-resultsSkill
- measure-instrumentation-specSkill
- measure-okr-graderSkill
- measure-survey-analysisSkill
- tool-design-sprint-briefSkill
- tool-design-sprint-decide-and-storyboardSkill
- tool-design-sprint-map-and-targetSkill
- tool-design-sprint-prototype-planSkill
- tool-design-sprint-readinessSkill
- tool-design-sprint-sketchSkill
- tool-design-sprint-test-and-scoreSkill
- tool-foundation-sprint-approach-optionsSkill
- tool-foundation-sprint-basicsSkill
- tool-foundation-sprint-briefSkill
- tool-foundation-sprint-differentiationSkill
- tool-foundation-sprint-founding-hypothesisSkill
- tool-foundation-sprint-magic-lensesSkill
- tool-foundation-sprint-readinessSkill
- tool-note-and-voteSkill
- utility-mermaid-diagramsSkill
- utility-pm-changelog-curatorSkill
- utility-pm-criticSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
When asked to create a solution brief, follow these steps:
- Distinctive: line 50
Document what you're explicitly NOT doing and why.
- Very specific: line 60
Use the template in references/TEMPLATE.md to structure the output.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<!-- 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-statementfirst - You are recording a decision already made -> use
develop-adr(technical) ordevelop-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:
- 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.
- 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.
- 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.
- 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.
- 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.
- Identify Risks and Mitigations Surface the biggest risks to success and your plan to address them. This builds stakeholder confidence and surfaces concerns early.
- 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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

