sdd-design

Generate structured design.md documents with architecture and security threat matrices.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/LuisAlbertoMK/gentleman-agent-gh --skill sdd-design-luisalbertomk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-design
Source: https://github.com/LuisAlbertoMK/gentleman-agent-gh/tree/main/internal/assets/skills/sdd-design
Command: npx skills add https://github.com/LuisAlbertoMK/gentleman-agent-gh --skill sdd-design-luisalbertomk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the lack of structured technical planning in AI-driven development by enforcing a rigorous, spec-driven design process that ensures architecture decisions are documented, reviewed, and aligned with project standards.

Core Features & Use Cases

  • Technical Design Generation: Automatically produces a comprehensive design.md document covering architecture, data flow, and file changes.
  • Applicability-Driven Threat Modeling: Integrates a mandatory security matrix to identify and mitigate risks in routing, shell commands, and process integration.
  • Standardized Persistence: Ensures all design artifacts are consistently stored and versioned according to the project's chosen storage mode (engram, openspec, or hybrid).

Quick Start

Instruct the orchestrator to launch the sdd-design skill for your current change proposal to generate the technical architecture and threat matrix.

Frequently Asked Questions about sdd-design

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

FAQPage Schema
How do I generate technical design documentation for software development?

Technical design documentation is generated by creating a structured design.md file that defines architecture, data flow, and implementation strategies within the Spec-Driven Development framework.

What is the best way to perform threat modeling for technical architecture?

Threat modeling for technical architecture is performed by generating a mandatory security matrix that identifies and mitigates risks in routing, shell commands, and process integration.

How do I standardize architecture specification persistence across projects?

Architecture specification persistence is standardized by enforcing consistent storage and versioning of design artifacts according to a project's chosen storage mode, such as engram, openspec, or hybrid.

When do I need spec-driven design for software architecture?

Spec-driven design for software architecture is needed when you lack structured technical planning in AI-driven development and must ensure architecture decisions are documented, reviewed, and aligned with project standards.

Can I use this workflow to document file changes and data flows?

Yes, you can use this workflow to automatically produce comprehensive technical designs that document file changes, data flows, and architecture rationale for your software development tasks.

Does this approach require specific conventions for technical rationale documentation?

Yes, this approach requires strict adherence to project-specific conventions for artifact persistence and technical rationale documentation to maintain alignment with project standards.