$npx skillfedfor your agent

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

★ 305  42 MITupdated by rsmdt

Decision gist · record as of 2026-05-07

specify-solution creates and validates solution design documents by capturing architecture decisions and technical design rationale. 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.

manual: git clone https://github.com/rsmdt/the-startup → cp -r the-startup/plugins/start/skills/specify-solution ~/.claude/skills/specify-solution
plugins/start/skills/specify-solution/SKILL.md · version 654abcf3

Use it when

  • specify-solution generates architecture decision records (ADRs) with trade-off analysis to document your technical choices.
  • specify-solution validates your SDD for MECE compliance and consistency.

Verify before relying

Read SKILL.md below before installing (8 files). Open directory: indexed for reading, not audited.

Same gist for agents: .md · .json

Install

rsmdt/the-startup/specify-solution · repository language: Shell

Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.

Frequently 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)

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

Let your AI agent find skills like this

Example. Real query, live index.

You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.

wish › “Create and validate solution design documents with architecture decisions”

Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →

Related skills

architecture-selection
by rsmdt · rsmdt/the-startup

Architecture Selection helps teams pick the best system design by evaluating patterns against team size, domain complexity, scaling needs, and operational maturity. It scores candidates using weighted criteria, documents trade-offs, and provides migration paths—avoiding resume-driven choices and premature optimization. Use it to design new systems, plan migrations, or review existing architectures.

MITupdated May 2026
★ 305repo stars
technical-writing
by rsmdt · rsmdt/the-startup

This skill produces structured technical documentation across four types: architectural decision records for design choices, system overviews for onboarding, API references for integrations, and operational runbooks for procedures. It enforces anti-patterns like documentation drift and future fiction while matching detail to audience—from high-level concepts for new developers to procedural steps for operations teams.

MITupdated May 2026
★ 305repo stars
database-design
by srstomp · srstomp/pokayokay

Build well-structured database schemas from requirements through deployment. This skill guides you through normalization, relationship design, index optimization, and reversible migrations—covering relational databases like PostgreSQL and MySQL, document stores like MongoDB, and ORMs including Prisma, Drizzle, and TypeORM.

MITupdated Jul 2026
★ 9repo stars
doc-prd
by vladm3105 · vladm3105/aidoc-flow-framework

doc-prd generates a Product Requirements Document as Layer 2 of the SDD workflow, converting business requirements into product capabilities, user personas, and measurable success criteria. It structures features and acceptance criteria at the container level, sitting between upstream BRD and downstream EARS artifacts.

MITupdated Jul 2026
★ 16repo stars
design-brief
by julianoczkowski · julianoczkowski/designer-skills

Design Brief walks you through a structured conversation to define a new feature or page, then scans your codebase for existing design tokens, components, and patterns. It produces a markdown brief that captures the problem, solution, design principles, aesthetic direction, and component inventory—ensuring your design extends rather than duplicates existing work.

Apache-2.0updated Jul 2026
★ 461repo stars
design-md
by mateaix · mateaix/mateclaw

design-md lets you create and validate DESIGN.md files—Google's open spec for encoding design systems as machine-readable tokens plus human-readable rationale. The included CLI lints structure, checks WCAG color contrast, diffs versions for regressions, and exports to Tailwind or W3C DTCG JSON formats.

Apache-2.0updated Jul 2026
★ 796repo stars
Tags
arch-documentationdesign-validationdecision-tracingsystem-blueprintinterface-contractscomponent-partitionrequirements-mappingdesign-reviewspecification-frameworktechnical-governance