sdd-design

Generate design.md documents capturing architecture decisions and data flows.

1|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/RamonsDka/the-architect-overlay --skill sdd-design-ramonsdka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/RamonsDka/the-architect-overlay/tree/main/skills/sdd-design
Command: npx skills add https://github.com/RamonsDka/the-architect-overlay --skill sdd-design-ramonsdka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables the automatic creation of a technical design document that captures architecture decisions, data flows, and rationale for a given change, ensuring consistent design artifacts across teams.

Core Features & Use Cases

  • Generate a design.md capturing architecture decisions, data flows, file changes, and rationale from proposals/specs.
  • Read the codebase and orchestrator inputs to tailor the design to the actual project.
  • Persist the design content via Engram, OpenSpec, or Hybrid backends and emit a ready-to-use document.
  • Use Case: When a change proposal is approved, run the sdd-design skill to produce a complete design doc ready for review.

Quick Start

Submit a change proposal and let the orchestrator trigger sdd-design to generate a design.md

Frequently Asked Questions about sdd-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically draft architecture design documentation from a codebase?

You can automatically draft architecture design documentation by analyzing your codebase and a proposed change name to generate a design.md file. This process captures architecture decisions, data-flow diagrams, and file-change rationale tailored to your project.

What is the best way to generate data-flow diagrams and file-change plans for a software proposal?

The best way to generate data-flow diagrams and file-change plans is to use an automated design doc tool that reads your codebase and orchestrator inputs. It directly produces design rationale and architectural artifacts ready for team review.

Does this design doc generator support persisting architecture decisions via Engram, OpenSpec, or hybrid backends?

Yes, this design doc generator supports persisting architecture decisions via Engram, OpenSpec, or hybrid backends. It emits the generated design.md content directly to your chosen backend for consistent document storage and retrieval.

Can I use this to create a design rationale document when evaluating a proposed change in a software project?

Yes, you can use this to create a design rationale document when evaluating a proposed change. It requires access to the codebase and the orchestrator's change-name to produce comprehensive architecture documentation and file-change plans.

How do I document architecture decisions and data flows after a change proposal is approved?

To document architecture decisions and data flows after a change proposal is approved, trigger an automated design generation skill against your codebase. It instantly produces a complete design.md capturing all rationale and data-flow diagrams for review.

Are there limitations when generating technical design documents for large or complex codebases?

Generating technical design documents for large codebases requires sufficient access to the project files and accurate orchestrator mode inputs. If codebase access is incomplete, the resulting data-flow diagrams and file-change plans may lack necessary context.