system-design-techniques

Create architecture specifications with C4 diagrams, bounded contexts, and RESTful API conventions.

2|Updated May 4, 2026
One-click install
npx skills add https://github.com/volodchenkov/claude-sdlc-agents --skill system-design-techniques
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design-techniques
Source: https://github.com/volodchenkov/claude-sdlc-agents/tree/main/skills/system-design-techniques
Command: npx skills add https://github.com/volodchenkov/claude-sdlc-agents --skill system-design-techniques

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps system analysts transform detailed requirements into comprehensive technical specifications and architecture models, ensuring clarity and traceability.

Core Features & Use Cases

  • Architectural Modeling: Guides the creation of system context and container diagrams using industry standards like C4.
  • Domain Mapping: Assists in identifying bounded contexts and service boundaries based on DDD principles.
  • API Design: Offers conventions and best practices for designing RESTful APIs, versioning, and error handling.
  • Use Case: A system analyst documents the architecture for a new feature involving multiple backend services and external integrations using Mermaid diagrams and structured specifications.

Quick Start

Refer to the skill to produce architecture diagrams, API contracts, and DDD mappings for your project requirements.

Frequently Asked Questions about system-design-techniques

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

FAQPage Schema
How do I translate business requirements into a clear system architecture specification?

To translate requirements into architecture specifications, you need structured techniques that map domain contexts, define API conventions, and model system scenarios. This ensures technical documentation maintains consistency, traceability, and adherence to industry standards.

What is the best way to model bounded contexts for a new software feature?

Modeling bounded contexts uses Domain-Driven Design (DDD) principles to identify service boundaries. By mapping domain boundaries, system analysts establish clear architectural scopes that support scenario modeling and decision rationale documentation for complex system designs.

How do I create C4 diagrams for backend services and external integrations?

Creating C4 diagrams involves generating system context and container visualizations using Mermaid. This architectural modeling approach provides structured techniques for documenting multiple backend services and external integrations with clear, scalable architecture.

Does this approach support documenting RESTful API conventions and error handling?

Yes, documenting RESTful API conventions is supported with best practices for versioning and error handling. It offers specific techniques to design API contracts, ensuring consistency and traceability across technical specifications for complex system designs.

Can I use this to document decision rationale for complex system designs?

Yes, you can document decision rationale using Architecture Decision Records (ADR). It supports scenario modeling and decision rationale documentation, ensuring traceability and adherence to industry standards when analysts develop comprehensive architecture specifications.