architecture-designer

Design and evaluate system architectures while capturing architectural decisions.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Blake-John/agent-config --skill architecture-designer-blake-john
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/Blake-John/agent-config/tree/main/.agents/skill_spec/architecture-designer
Command: npx skills add https://github.com/Blake-John/agent-config --skill architecture-designer-blake-john

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architecture design and ADR management for complex systems, enabling clear decisions, diagrams, and traceability.

Core Features & Use Cases

  • Architecture diagrams: Create clear visual representations of system components and interactions.
  • ADR authoring: Capture decisions with rationale and trade-offs.
  • Trade-off analysis: Systematically compare patterns, technologies, and constraints for scalable designs.
  • Guidance for non-functional requirements: Incorporate reliability, performance, and security considerations.

Quick Start

Create an architecture diagram for a proposed microservice sketch and document the ADRs.

Frequently Asked Questions about architecture-designer

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

FAQPage Schema
How do I document architectural decisions for microservices?

Document architectural decisions for microservices by authoring Architecture Decision Records (ADRs) that capture the rationale, trade-offs, and consistent decision criteria for each choice. ADRs provide traceability and context for system design reviews.

What is the best way to analyze technology trade-offs for scalable system design?

Analyzing technology trade-offs for scalable system design involves systematically comparing patterns, technologies, and constraints. This process incorporates non-functional requirements like reliability and performance to evaluate high-level infrastructure patterns.

How do I create architecture diagrams for system design reviews?

Create architecture diagrams to provide clear visual representations of system components and their interactions. These diagrams enforce consistent design criteria and are applied during system design reviews to evaluate proposed microservices.

Can I use this for scalability planning and non-functional requirements guidance?

Yes, you can use this for scalability planning across microservices and infrastructure patterns. It provides explicit guidance for non-functional requirements, incorporating reliability, performance, and security considerations into architecture evaluation.

When do I need to perform a risk assessment for system architecture?

Perform a risk assessment for system architecture when evaluating high-level designs and technology trade-offs for scalable systems. Risk assessment is enforced alongside ADR documentation to ensure non-functional requirements are systematically addressed.