sdd-design

Generates technical design documents with architecture decisions, file changes, and threat matrices for SDD changes.

Updated May 24, 2026
One-click install
npx skills add https://github.com/etrigan16/v0-cipher-ar --skill sdd-design-etrigan16
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/etrigan16/v0-cipher-ar/tree/main/.opencode/skills/sdd-design
Command: npx skills add https://github.com/etrigan16/v0-cipher-ar --skill sdd-design-etrigan16

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It turns an approved change proposal and specs into a concrete technical design, documenting architecture decisions, data flow, file changes, and testing strategy so implementation work starts from a clear, reviewed plan instead of guesswork. ## Core Features & Use Cases - Design Document Generation: Produces a structured design.md covering technical approach, architecture decisions with rationale, data flow diagrams, file change tables, interfaces, and testing strategy. - Multi-Mode Persistence: Stores the design artifact via Engram topics, OpenSpec filesystem conventions, hybrid mode, or returns it inline depending on the artifact store mode. - Applicability-Driven Threat Matrix: Includes a security threat matrix for designs touching routing, shell commands, subprocesses, VCS/PR automation, or process integration, with planned RED tests. - Use Case: An orchestrator delegates a change named "add-oauth-login" to this sub-agent, which reads the codebase and proposal, then writes a design.md documenting the auth flow, affected files, and test plan before task breakdown begins. ## Quick Start Ask the orchestrator to run the SDD design phase for your change, for example: "Create the technical design for the add-oauth-login change using the proposal and specs."

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 for a software change?▼

Delegate the design phase to the sdd-design sub-agent with the change name and artifact store mode. It reads the proposal, specs, and actual codebase, then produces a design.md with architecture decisions, data flow, file changes, and testing strategy.

What should a software design document include before implementation?▼

A design document should include the technical approach, architecture decisions with rationale and rejected alternatives, data flow, a file change table, interfaces or contracts, a testing strategy, and open questions. This skill enforces that structure with an 800-word size budget.

Does this skill work with OpenSpec and Engram artifact storage?▼

Yes, it supports four artifact store modes: engram, openspec, hybrid, and none. Engram persists to topic keys like sdd/{change-name}/design, openspec writes design.md to the filesystem, hybrid does both, and none returns the result inline.

When is the threat matrix required in a design document?▼

The threat matrix is required only when the design changes routing, shell commands, subprocesses, VCS/PR automation, executable-file classification, or process integration. Otherwise it is recorded as not applicable rather than expanded with irrelevant rows.

Can the orchestrator run this skill's instructions directly?▼

No, the skill is delegate-only and marked non-user-invocable. The orchestrator must delegate to the dedicated sdd-design sub-agent; only that executor sub-agent runs the phase instructions.