sdd-design

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

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AD-Paladins/beaconator-web --skill sdd-design-ad-paladins
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/AD-Paladins/beaconator-web/tree/main/.config/opencode/skills/sdd-design
Command: npx skills add https://github.com/AD-Paladins/beaconator-web --skill sdd-design-ad-paladins

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, eliminating guesswork about architecture decisions, file changes, and testing strategy before implementation begins. ## Core Features & Use Cases - Design Document Generation: Produces a structured design.md covering technical approach, architecture decisions with rationale, data flow diagrams, file changes, interfaces, and testing strategy. - Multi-Mode Persistence: Supports engram, openspec, hybrid, and none artifact store modes, reading proposals and specs from the appropriate source and persisting the design accordingly. - Threat Matrix Integration: Applies an applicability-driven threat matrix for designs touching routing, shell commands, subprocesses, VCS/PR automation, or process integration, propagating applicable rows into tasks and RED tests. - Use Case: After a change proposal is approved, the orchestrator delegates to this sub-agent, which reads the actual codebase, documents each architecture decision with alternatives and rationale, and returns a summary ready for the task-planning phase. ## Quick Start Delegate the design phase for an approved change to the sdd-design sub-agent so it reads the codebase and produces the design artifact.

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 actual codebase, proposal, and specs, 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 alternatives and rationale, data flow, a file change table, interfaces and contracts, a testing strategy, and open questions. This skill enforces that structure with an 800-word size budget.

Can the design phase run in parallel with spec writing?▼

Yes. In engram mode the spec artifact is optional, so the design sub-agent can run in parallel with sdd-spec. It reads the proposal as required input and treats the spec as optional context.

When is the threat matrix required in a design?▼

The threat matrix applies 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.

What artifact storage modes does the design phase support?▼

Four modes are supported: engram persists to a topic key, openspec writes design.md under openspec/changes, hybrid does both, and none returns the result inline without creating project files.