architecture-designer

Design scalable system architectures and document decisions with ADRs.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/preedep/kham --skill architecture-designer-preedep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/preedep/kham/tree/main/.claude/skills/architecture-designer
Command: npx skills add https://github.com/preedep/kham --skill architecture-designer-preedep

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architects and teams face the challenge of designing scalable system architectures and documenting key decisions. This skill provides a structured approach to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, and plan for scalable infrastructure.

Core Features & Use Cases

  • Create architecture diagrams (Mermaid) and visualize component interactions.
  • Author Architecture Decision Records (ADRs) to capture rationale and trade-offs.
  • Evaluate technology options and patterns for scalability, reliability, and maintainability.
  • Review architecture with stakeholders and plan for microservices boundaries and infrastructure patterns.

Quick Start

Generate a high-level architecture diagram and an ADR outline for a scalable system design, including candidate components and technology trade-offs.

Frequently Asked Questions about architecture-designer

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

FAQPage Schema
How do I design scalable system architectures and document the decisions?

Author Architecture Decision Records (ADRs) to document trade-offs and rationale, and generate Mermaid architecture diagrams to visualize scalable system designs and component interactions for stakeholder reviews.

How do I write an Architecture Decision Record for microservices planning?

Use ADR templates to capture rationale and technology trade-offs during microservices planning, ensuring your architecture decisions for scalability and maintainability are properly documented.

What is the best way to visualize system design and component interactions?

Generate Mermaid architecture diagrams to visualize component interactions and candidate components, providing a clear system design overview for stakeholder reviews and microservices boundary planning.

Can I evaluate technology trade-offs for scalability and maintainability during an architecture review?

Evaluate technology options and patterns to analyze trade-offs affecting scalability, reliability, and maintainability, directly guiding your design decisions during stakeholder architecture reviews.

When do I need Architecture Decision Records for system design?

You need Architecture Decision Records when designing scalable systems to document technology trade-offs and rationale, providing a structured approach for architecture reviews and infrastructure planning.