sdd-design

Generate technical design documents for software changes from proposals and specifications.

Updated Feb 21, 2026

Search Tags:#design #architecture #decision making #software development #technical documentation #sdd

Ready to run

npx skills add https://github.com/josemartinrodriguezmortaloni/opencode-config --skill sdd-design-josemartinrodriguezmortaloni

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/josemartinrodriguezmortaloni/opencode-config/tree/main/skill/sdd-design
Command: npx skills add https://github.com/josemartinrodriguezmortaloni/opencode-config --skill sdd-design-josemartinrodriguezmortaloni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of detailed technical design documents, ensuring that the 'how' of a software change is clearly articulated before implementation.

Core Features & Use Cases

Architecture Decisions: Documents specific technical choices, alternatives, and their rationale.
Data Flow Visualization: Clearly outlines how data moves through the system using diagrams.
File Change Management: Lists all files to be created, modified, or deleted.
Use Case: When a new feature is proposed, this Skill generates a design.md file detailing the proposed architecture, data structures, and file modifications, ensuring alignment before coding begins.

Quick Start

Use the sdd-design skill to create a technical design document for the 'user-authentication' change.

Frequently Asked Questions about sdd-design

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

FAQPage Schema

How do I generate a technical design document for a software change proposal?▼

To generate a technical design document, you provide a software change proposal and specification. The system processes these inputs to capture architecture decisions, data flow, file modifications, interface contracts, and testing strategies, persisting the output to a design.md file.

What is the Spec-Driven Development framework for technical documentation?▼

Spec-Driven Development (SDD) is a framework ensuring the how of a software change is clearly articulated before implementation. It automates detailed technical design documents to align architecture decisions and file modifications before coding begins.

How do I document architecture decisions and data flow for a new feature?▼

You document architecture decisions and data flow by running the SDD design process on your feature proposal. It outlines specific technical choices, their rationale, alternatives, and visualizes how data moves through the system using diagrams.

Does this technical design generation work without external dependencies?▼

Yes, technical design generation runs without external dependencies. It operates entirely within the Spec-Driven Development framework using internal scripts and references to produce the design document.

Can I persist design documents to Engram instead of a local file?▼

Yes, you can persist design documents to Engram. The skill supports artifact store mode, allowing outputs to be saved either to Engram or directly to the openspec/changes directory as a markdown file.

What is the best way to manage file change tracking before implementation?▼

The best way to manage file change tracking is using an SDD design document. It explicitly lists all files to be created, modified, or deleted, ensuring complete alignment on data structures and modifications before coding begins.