architecture-designer

Design high-level system architectures with patterns, diagrams, and ADRs.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/hyagoviana/Sistema_Hyago_Viana_Adabtech --skill architecture-designer-hyagoviana
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/hyagoviana/Sistema_Hyago_Viana_Adabtech/tree/main/.agents/skills/architecture-designer
Command: npx skills add https://github.com/hyagoviana/Sistema_Hyago_Viana_Adabtech --skill architecture-designer-hyagoviana

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you create and validate high-level system architecture decisions that balance scalability, maintainability, and operational reality.

Core Features & Use Cases

  • Architecture design workflow: turn requirements (functional and non-functional) into a coherent architecture with explicit trade-offs.
  • ADRs (Architecture Decision Records): document key decisions, alternatives considered, and consequences for long-term traceability.
  • Pattern-guided structuring: choose architectural patterns (monolith, modular monolith, microservices, serverless, event-driven, CQRS) aligned to the problem.
  • Output-ready artifacts: produce a Mermaid architecture diagram plus a set of ADRs, risks, and mitigations.

Quick Start

Use the architecture-designer skill to draft a high-level architecture and ADR set for a scalable microservices platform based on the provided requirements.

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 architecture with clear technology trade-offs?

Designing scalable system architecture with clear trade-offs requires structuring high-level decisions using patterns, diagrams, and Architecture Decision Records. This approach reduces uncertainty in system structuring while explicitly balancing maintainability and operational reality.

When do I need Architecture Decision Records for microservices decomposition?

You need Architecture Decision Records for microservices decomposition to document key decisions, alternatives considered, and consequences. ADRs ensure long-term traceability and satisfy the need for explicit trade-off documentation during architecture reviews.

What is the best way to map non-functional requirements to infrastructure patterns?

The best way to map non-functional requirements to infrastructure patterns is through pattern-guided structuring. This method aligns architectural patterns like serverless or event-driven systems directly to the operational and security considerations of your specific problem.

Can I generate Mermaid system diagrams from functional and non-functional requirements?

Yes, you can generate Mermaid system diagrams from functional and non-functional requirements. The architecture design workflow turns requirements into a coherent architecture, producing output-ready artifacts like Mermaid diagrams alongside ADRs and risk mitigations.

Does this approach work for both monolith and microservices scalability planning?

Yes, this approach works for both monolith and microservices scalability planning. Pattern-guided structuring helps you choose appropriate architectural patterns, including modular monoliths, microservices, CQRS, and event-driven designs, based on your specific operational requirements.

Why should I not use microservices architecture for every new system design?

You should not use microservices for every new system design because it introduces operational complexity. Choosing architectural patterns aligned to the problem ensures you capture necessary technology trade-offs, potentially selecting a modular monolith or serverless approach instead.