design

Generate Software Architecture Documents from feature specifications using Arc42 and C4 diagrams.

89|32|Updated May 28, 2026
One-click install
npx skills add https://github.com/genkovich/sdd --skill design-genkovich
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/genkovich/sdd/tree/main/skills/design
Command: npx skills add https://github.com/genkovich/sdd --skill design-genkovich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, mermaid, pdf2image, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the generation of a Software Architecture Document (SAD) and supports its review, saving significant time and effort in the documentation process.

Core Features & Use Cases

  • Automated SAD Generation: Creates a comprehensive SAD based on the feature specification, using a 12-section Arc42 template and C4 diagrams.
  • Decision-Driven Approach: Encourages thoughtful decision-making through interactive questioning and provides guidance for architecture choices.
  • ADR Integration: Tracks architectural decisions in a separate document, ensuring all decisions are captured and documented.
  • Critic Feedback: Offers critical feedback on the generated SAD, helping refine and improve the architecture.

Quick Start

To generate an SAD for a feature, run the command: $sdd-design <slug>

Frequently Asked Questions about design

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

FAQPage Schema
How do I automate software architecture document generation from feature specifications?

Automating software architecture document generation uses feature specifications to produce a comprehensive SAD, capturing architectural decisions interactively while applying a 12-section Arc42 template with C4 diagrams.

What is the best way to document architectural decisions during software design?

Documenting architectural decisions during software design is handled by tracking choices in a separate Architecture Decision Record, ensuring all decisions are captured and reviewed alongside the generated SAD.

Does this SAD generation approach use C4 diagrams and the Arc42 template?

Yes, this SAD generation approach uses C4 diagrams for visual modeling and the Arc42 template to structure the 12 sections of the software architecture document based on your feature context.

How do I review a generated software architecture document for quality?

Reviewing a generated software architecture document for quality is supported by a critic feedback mechanism that offers critical analysis on the SAD, helping refine and improve the overall architecture.

Do I need Python and Mermaid to generate architecture documents with this tool?

Generating architecture documents with this tool requires Python, Mermaid for rendering C4 diagrams, and pdf2image as dependencies to automate the SAD workflow and visual outputs.