specify-solution
specify-solution guides you through building solution design documents (SDDs) that capture how your system will be built. It structures your architecture decisions as traceable ADRs, validates that every requirement maps to a component, and ensures your design is complete and conflict-free before implementation begins.
specify-solution creates and validates solution design documents by capturing architecture decisions and technical design rationale.
AI-generated summary based on this skill's SKILL.md
Install
rsmdt/the-startup/specify-solution · repository language: Shell
git clone https://github.com/rsmdt/the-startup
cp -r the-startup/plugins/start/skills/specify-solution ~/.claude/skills/specify-solutionnpx skillfed install rsmdt/the-startup/specify-solutionFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I create a solution design document?
specify-solution guides you through building solution design documents (SDDs) that capture how your system will be built. The skill structures your architecture decisions as traceable ADRs, validates that every requirement maps to a component, and ensures your design is complete and conflict-free before implementation begins.
What is an architecture decision record and how does specify-solution help create one?
specify-solution generates architecture decision records (ADRs) with trade-off analysis to document your technical choices. Each ADR captures the decision, its context, alternatives considered, and consequences, making your architectural reasoning transparent and reviewable by your team.
How does specify-solution validate solution design documents?
specify-solution validates your SDD for MECE compliance and consistency, ensuring every PRD requirement maps to a system component and that your design contains no gaps or overlaps. This validation step confirms your design is complete and ready for implementation.
Can specify-solution document technical architecture and interfaces?
Yes. specify-solution helps you document technical architecture, interfaces, and design decisions in a structured format. It maps PRD requirements to system components, ensuring all technical details are captured and validated before you begin building.
What does specify-solution include in a solution design specification?
specify-solution creates SDDs that include architecture decisions, system components, data models, interfaces, and trade-off analysis. The skill ensures your specification is traceable, complete, and ready for architectural design review and implementation planning.
SKILL.md
rendered from the published skill — quoted content, verbatim
Persona
Act as a solution design specialist that creates and validates SDDs focusing on HOW the solution will be built through technical architecture and design decisions.
Interface
SddSection { status: Complete | NeedsDecision | InProgress | Pending adrs?: ArchitectureDecision[] }
ArchitectureDecision { id: string // ADR-1, ADR-2, ... name: string choice: string rationale: string tradeoffs: string confirmed: boolean // requires user confirmation }
State { specDirectory = "" // .start/specs/[NNN]-[name]/ (or legacy docs/specs/) prd = "" // path to requirements.md (or product-requirements.md) sdd = "" // path to solution.md (or solution-design.md) sections: SddSection[] adrs: ArchitectureDecision[] }
Constraints
Always: - Focus exclusively on research, design, and documentation — never implementation. - Follow template
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 8 files
plugins/start/skills/specify-solution/SKILL.md
plugins/start/skills/specify-solution/evals/evals.json
plugins/start/skills/specify-solution/examples/architecture-examples.md
plugins/start/skills/specify-solution/examples/output-example.md
plugins/start/skills/specify-solution/reference/focus-and-mece.md
plugins/start/skills/specify-solution/reference/output-format.md
plugins/start/skills/specify-solution/template.md
plugins/start/skills/specify-solution/validation.md