sdd-design

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

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/Alountk/Bloodbowl_Project --skill sdd-design-alountk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/Alountk/Bloodbowl_Project/tree/main/.opencode/skills/sdd-design
Command: npx skills add https://github.com/Alountk/Bloodbowl_Project --skill sdd-design-alountk

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 before implementation begins. ## Core Features & Use Cases - Structured design.md generation: Produces a design document with technical approach, architecture decisions with rationale, data flow diagrams, file change tables, interfaces, and testing strategy. - Multi-mode artifact persistence: Supports engram, openspec, hybrid, and none storage modes, reading proposals and specs from the appropriate source and persisting the design accordingly. - 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-journeymen-signing" to this sub-agent, which reads the codebase and proposal, then writes a design.md documenting decisions, affected files, and test plans. ## Quick Start Delegate the design phase for a named change to the sdd-design sub-agent so it reads the proposal and codebase and produces the 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 in an SDD workflow?▼

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

What artifact storage modes does the SDD design phase support?▼

Four modes are supported: engram persists to a topic key like sdd/{change-name}/design, openspec writes design.md under openspec/changes/, 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 only when the design changes routing, shell commands, subprocesses, VCS or PR automation, executable-file classification, or process integration. Otherwise it is recorded as not applicable with a reason.

Can the orchestrator execute the sdd-design skill directly?▼

No. The skill has an orchestrator gate: if loaded via the skill tool, the orchestrator must delegate to the dedicated sdd-design sub-agent rather than executing the instructions inline.

What are the size and content limits for the design document?▼

The design artifact must stay under 800 words, use tables for architecture decisions, and include code snippets only for non-obvious patterns. Every decision requires a rationale and concrete file paths.