sdd-design

Generates technical design documents with architecture decisions, data flow, and file changes for SDD changes.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill sdd-design-carloswilliamsr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/CarlosWilliamsR/SketchOS/tree/main/.config/opencode/skills/sdd-design
Command: npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill sdd-design-carloswilliamsr

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 document, capturing architecture decisions, data flow, file changes, and testing strategy so implementation work starts from a documented plan rather than guesswork. ## Core Features & Use Cases - Design Document Generation: Produces a design.md with architecture decisions, alternatives considered, data flow diagrams, file change tables, and interface contracts. - Multi-Mode Persistence: Supports engram, openspec, hybrid, and none artifact store modes, reading proposals and specs from the appropriate source. - Threat Matrix Integration: Applies an applicability-driven threat matrix for designs touching routing, shell commands, subprocesses, or VCS/PR automation, propagating cases to RED tests. - Use Case: After a change proposal is approved, the orchestrator delegates to this sub-agent, which reads the actual codebase and returns a design under 800 words ready for task breakdown. ## Quick Start Delegate the design phase for my approved change to the sdd-design sub-agent so it produces the technical design document.

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 covering architecture decisions, data flow, file changes, and testing strategy.

What artifact store modes does the SDD design phase support?

It supports engram, openspec, hybrid, and none modes. Engram persists to a topic key, openspec writes design.md to the filesystem, hybrid does both, and none returns the result inline without creating files.

When is the threat matrix required in a design document?

The threat matrix is required when the design changes routing, shell commands, subprocesses, VCS/PR automation, executable-file classification, or process integration. Each row is marked Applicable or N/A with a reason, and applicable rows propagate to tasks and RED tests.

Can the design skill run without reading the codebase first?

No. The skill mandates reading the actual codebase before designing, including entry points, existing patterns, dependencies, and test infrastructure. It must follow the project's existing conventions rather than generic best practices.

What are the size limits for the SDD design artifact?

The design artifact must stay under 800 words. Architecture decisions are expressed as tables with options, tradeoffs, and decisions, and code snippets are included only for non-obvious patterns.