sdd-design

Generates technical design documents with architecture decisions and file changes for SDD workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents often jump straight to implementation without a documented technical design, leading to inconsistent architecture decisions and untraceable rationale. This Skill enforces a design phase in a Spec-Driven Development (SDD) pipeline, producing a structured design.md that captures how a change will be implemented before any code is written. ## Core Features & Use Cases - Structured Design Documents: Produces a design.md with technical approach, architecture decisions (choice, alternatives, rationale), data flow diagrams, file change tables, interfaces, and testing strategy. - Multi-Mode Persistence: Supports engram, openspec, hybrid, and none artifact store modes, reading the proposal and spec artifacts and persisting the design accordingly. - Codebase-Grounded Design: Requires reading the actual affected code, existing patterns, and test infrastructure before designing, so decisions follow project conventions rather than generic best practices. - Use Case: An orchestrator delegates a change to this sub-agent after the proposal and spec phases; it reads the codebase, writes an architecture design under 800 words, persists it, and returns a summary ready for the task-breakdown phase. ## Quick Start Delegate the design phase for a change by invoking the sdd-design sub-agent with the change name and artifact store mode after the proposal and spec artifacts exist.

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 a spec-driven development workflow?▼

Delegate the design phase to the sdd-design sub-agent with the change name and artifact store mode. It reads the proposal and spec artifacts, inspects the codebase, and produces a design.md covering 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 or contracts, a testing strategy, migration plans, and open questions. This Skill enforces that exact structure with an 800-word budget.

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

Yes. The spec artifact is optional input for this Skill, so it can run in parallel with sdd-spec. The proposal artifact is required and must exist before the design phase starts.

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

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

Why should an AI agent read the codebase before writing a design?▼

Reading the actual code ensures the design follows existing patterns, conventions, dependencies, and test infrastructure instead of generic best practices. This Skill mandates codebase reading and requires concrete file paths rather than abstract descriptions.