sdd-system-design

Generate ARCHITECTURE.md, DEPLOYMENT.md, SECURITY.md, and COMPLIANCE_MATRIX.md from SPEC.md.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/franztrierweiler/claude-code-skills --skill sdd-system-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-system-design
Source: https://github.com/franztrierweiler/claude-code-skills/tree/main/skills/sdd-system-design
Command: npx skills add https://github.com/franztrierweiler/claude-code-skills --skill sdd-system-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Produit les documents de conception technique (architecture, déploiement, sécurité, conformité) à partir d'un SPEC.md existant selon la méthodologie SDD. Se déclenche quand l'utilisateur demande de concevoir l'architecture, le déploiement, la sécurité ou la conformité d'un projet SDD, ou quand il fournit un SPEC.md et demande la phase de conception. Ne se déclenche pas pour rédiger un SPEC.md (utiliser sdd-spec-write), écrire du code, faire une revue de code, ou planifier des EPICs.

Core Features & Use Cases

  • Génère ARCHITECTURE.md, DEPLOYMENT.md, SECURITY.md, et éventuellement COMPLIANCE_MATRIX.md à partir du SPEC.md.
  • Maintient la traçabilité en reliant les décisions aux exigences EXG-xxx et ENF-xxx.
  • Prend en charge un dialogue de conception itératif pour affiner l'architecture et les décisions.

Quick Start

Provide a SPEC.md and I will generate ARCHITECTURE.md, DEPLOYMENT.md, SECURITY.md, and COMPLIANCE_MATRIX.md following the SDD workflow.

Frequently Asked Questions about sdd-system-design

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

FAQPage Schema
How do I generate architecture and deployment documentation from a SPEC.md file?

To generate architecture and deployment documentation from a SPEC.md, use the SDD methodology to transform your requirements into ARCHITECTURE.md, DEPLOYMENT.md, SECURITY.md, and COMPLIANCE_MATRIX.md. This approach ensures traceability by linking technical decisions directly to your original requirements.

What is the SDD methodology for software design traceability?

The SDD methodology for software design traceability is a structured process that transforms a SPEC.md into technical documents while enforcing traceability. It ties architecture, deployment, security, and compliance decisions directly to specific EXG-xxx and ENF-xxx requirements defined in the specification.

Can I use a spec-to-docs workflow to create a security and compliance matrix for my project?

Yes, you can use a spec-to-docs workflow to create a security document and compliance matrix. By processing your existing SPEC.md through the SDD methodology, it generates SECURITY.md and COMPLIANCE_MATRIX.md, linking each security decision back to your original functional and non-functional requirements.

Does the SDD design phase support iterative refinement of architecture decisions?

Yes, the SDD design phase supports iterative refinement of architecture decisions. After generating the initial ARCHITECTURE.md and DEPLOYMENT.md from your SPEC.md, you can engage in an iterative dialogue to further refine the architecture, security constraints, and technical decisions while maintaining requirement traceability.

When should I not use a SPEC.md to architecture generator?

You should not use a SPEC.md to architecture generator when you need to write the initial SPEC.md, write application code, perform code reviews, or plan project EPICs. This tool is strictly for producing architecture, deployment, security, and compliance documentation from an already completed specification.