Design Architecture

Generate architecture documentation and Architectural Decision Records through structured interviews.

6|3|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/carson-sweet/sweetclaude --skill design-architecture-carson-sweet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Design Architecture
Source: https://github.com/carson-sweet/sweetclaude/tree/main/skills/design-architecture
Command: npx skills add https://github.com/carson-sweet/sweetclaude --skill design-architecture-carson-sweet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the challenge of inconsistent system design and poor documentation by guiding you through a structured architectural interview and automatically generating standardized Architectural Decision Records (ADRs).

Core Features & Use Cases

  • Structured Interviewing: Conducts a guided discovery process covering platform, architecture style, data, and compliance requirements.
  • Automated Documentation: Generates professional ADRs and a comprehensive architecture document based on your specific project needs.
  • Compliance Guardrails: Automatically flags regulated data requirements (PII, PHI, PCI) to ensure security is baked into the design.
  • Use Case: Use this when starting a new project to ensure your tech stack, database choices, and service boundaries are well-reasoned and documented for future team members.

Quick Start

Run the design architecture skill to begin the interview process for your new project and generate your initial architecture documentation.

Frequently Asked Questions about Design Architecture

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

FAQPage Schema
How do I generate Architectural Decision Records for a new software project?

You can generate Architectural Decision Records by running a structured, interview-based workflow that gathers platform, architecture, and compliance requirements, then automatically outputs standardized ADRs and architecture documentation.

What is the best way to document system design choices for a service-oriented architecture?

Documenting system design for service-oriented architectures is best handled through a guided discovery process that evaluates service boundaries and data requirements, producing comprehensive architecture documents to ensure consistency across the lifecycle.

How do you ensure compliance and security standards are met during system design?

To ensure compliance and security standards are met during system design, the workflow automatically flags regulated data requirements such as PII, PHI, and PCI, enforcing guardrails throughout the architectural decision process.

Can I use an automated interview to define my tech stack and database choices?

Yes, you can use an automated interview to define your tech stack and database choices by responding to a structured set of discovery questions that translate your project needs into a well-reasoned, documented architecture.

Does this architectural documentation workflow support both monoliths and service-oriented architectures?

Yes, this architectural documentation workflow supports both monoliths and service-oriented architectures, guiding technical decision-making and generating records that maintain architectural consistency for either structural pattern.

How do I maintain architectural consistency across the software development lifecycle?

You maintain architectural consistency across the development lifecycle by integrating generated architecture documents and ADRs with project state files, ensuring design decisions remain synchronized as the project evolves.