sdd-design

Creates technical design documents with architecture decisions, data flow, and file changes for spec-driven development.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/Balthael/ciberbal-ai --skill sdd-design-balthael
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/Balthael/ciberbal-ai/tree/main/internal/assets/skills/sdd-design
Command: npx skills add https://github.com/Balthael/ciberbal-ai --skill sdd-design-balthael

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a technical design that stays consistent with an existing codebase and a change proposal is slow and error-prone. This Skill acts as a design sub-agent that reads the actual code, then produces a structured design.md capturing architecture decisions, data flow, file changes, interfaces, and testing strategy. ## Core Features & Use Cases - Codebase-grounded design: Reads entry points, patterns, dependencies, and test infrastructure before designing, so decisions follow the project's real conventions. - Structured design document: Generates a design.md with architecture decisions (choice, alternatives, rationale), ASCII data-flow diagrams, file change tables, interface contracts, and a testing strategy. - Multi-mode persistence: Supports engram, openspec, hybrid, and none artifact store modes, persisting to Engram topics, openspec/changes directories, both, or returning inline only. - Use Case: During a spec-driven development workflow, the orchestrator launches this agent after the proposal phase to produce the technical design for a change, which the tasks phase then consumes. ## Quick Start Ask the orchestrator to run the sdd-design phase for your change name so it reads the proposal and codebase and writes 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 code change?

Launch the design phase with the change name and artifact store mode. The agent reads the proposal, inspects the affected codebase, and writes a design.md covering architecture decisions, data flow, file changes, interfaces, and testing strategy.

What is spec-driven development design phase?

It is the stage between proposal and task breakdown where the technical approach is documented. The design captures how the change will be implemented, including decisions with rationale, so downstream task generation has concrete guidance.

What artifact storage modes does the design phase support?

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

Does the design agent read the actual codebase before designing?

Yes. Reading entry points, module structure, existing patterns, dependencies, and test infrastructure is mandatory. The agent must follow the project's actual conventions rather than generic best practices.

What are the limitations of the generated design document?

The design artifact must stay under 800 words, with decisions expressed as compact tables and code snippets only for non-obvious patterns. Blocking open questions are reported rather than guessed.