sdd-design

Transform change proposals into implementation-ready technical design documents.

2|Updated Jul 29, 2025
One-click install
npx skills add https://github.com/kurojs/EnderDots --skill sdd-design-kurojs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/kurojs/EnderDots/tree/main/.config/opencode/skills/sdd-design
Command: npx skills add https://github.com/kurojs/EnderDots --skill sdd-design-kurojs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a proposed change into a clear, actionable technical design that explains architecture decisions, data flow, and required file changes before implementation begins.

Core Features & Use Cases

  • Change-to-design conversion: Produces a design.md artifact capturing HOW the change will be implemented from the proposal and codebase patterns.
  • Architecture + rationale documentation: Documents concrete decisions with alternatives considered and rationale, plus interfaces/contracts and testing strategy.
  • Artifact persistence by mode: Supports persisting design to Engram and/or writing openspec/changes/{change-name}/design.md depending on artifact store mode.

Quick Start

Use the orchestrator workflow to provide the change name and artifact store mode so this skill can read the proposal/spec, inspect the impacted codebase, and persist the resulting architecture design.

Frequently Asked Questions about sdd-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a change proposal into a technical architecture design?

To convert a change proposal into a technical architecture design, the skill reads your proposal or spec artifacts, inspects the codebase patterns, and generates an implementation-ready design file detailing data flow, file changes, interfaces, and testing strategy.

What should a technical design document include for a new software feature?

A technical design document should include architecture decisions with rationale, data flow mapping, required file changes, interface contracts, and a defined testing strategy to guide implementation from the initial change proposal.

How do I document architecture decisions and rationale before implementation?

You document architecture decisions and rationale by generating a design artifact that captures concrete choices, alternatives considered, interface definitions, and testing strategy based on the codebase review and proposal specifications.

Can I persist a technical design artifact to a custom file path?

Yes, you can persist the technical design artifact by configuring the artifact store mode, which allows saving the resulting architecture blueprint under the sdd directory or the openspec changes path.

Does this technical design approach require reading existing codebase patterns?

Yes, the technical design approach requires reading the relevant codebase patterns and proposal specifications to accurately map the data flow and determine the necessary file changes for the implementation blueprint.

What is the best way to plan a testing strategy during technical design?

The best way to plan a testing strategy during technical design is to generate a comprehensive design artifact that explicitly defines the testing approach alongside interface contracts and data flow before implementation begins.