sdd-design

Create technical design documents from proposals and specs.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/sebasmzg/sebas.dot --skill sdd-design-sebasmzg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/sebasmzg/sebas.dot/tree/main/.config/opencode/skills/sdd-design
Command: npx skills add https://github.com/sebasmzg/sebas.dot --skill sdd-design-sebasmzg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of implementation-level technical design documents from proposals and specs so engineering teams have consistent, actionable plans that include architecture decisions, file changes, data flow, testing, and rollout guidance.

Core Features & Use Cases

  • Design Authoring: Produce a design.md that documents technical approach, architecture decisions (with rationale), data flow diagrams, concrete file changes, interfaces/contracts, testing strategy, migration/rollout plans, and open questions.
  • Artifact Store Integration: Operate across engram, openspec, hybrid, and none modes by using mem_search, mem_get_observation, and mem_save or by writing openspec files to the repository filesystem when required.
  • Developer Workflow: Use this Skill when converting a proposal/spec into an implementation plan before task breakdown and task creation, ensuring persistence so subsequent pipeline stages can find the design.

Quick Start

Write a design document for change add-user-auth using engram mode and include architecture decisions, data flow, file changes, testing strategy, and migration plan.

Frequently Asked Questions about sdd-design

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

FAQPage Schema
How do I create a technical design document from a proposal spec?

To create a technical design document, this Skill retrieves proposals and specs from artifact stores, then generates architecture decisions, file-level change plans, testing strategies, and migration guidance. It operates across engram, openspec, hybrid, and none persistence modes.

What should an implementation-ready technical design include for a code refactor?

An implementation-ready technical design includes architecture decisions with rationale, data flow diagrams, concrete file changes, interface contracts, testing strategy, and migration or rollout plans. It also tracks open questions to ensure actionable engineering plans.

Can I use OpenSpec to persist design documents to the filesystem?

Yes, you can use OpenSpec mode to persist design documents by writing openspec files directly to the repository filesystem. The Skill follows persistence conventions for engram, openspec, hybrid, and none modes to store the generated design.

How does artifact store integration work when generating architecture decisions?

Artifact store integration works by using mem_search and mem_get_observation to retrieve full proposal and spec content when required, then persisting the completed architecture decisions and design documents via mem_save or filesystem writes as specified.

When do I need an implementation-level design before task breakdown?

You need an implementation-level design before task breakdown when converting a proposal or spec into an actionable plan, ensuring the design is persisted so subsequent pipeline stages like task creation can reliably find and reference it.

Does this design generation approach work without external dependencies?

Yes, this approach works without external dependencies, operating independently to retrieve specs and persist designs using built-in memory search, observation retrieval, and filesystem write conventions across its supported persistence modes.