architecture-designer

Design system architectures and document key architectural decisions with ADRs.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Estom/aiflex --skill architecture-designer-estom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/Estom/aiflex/tree/main/skills-repo/Jeffallan-skills/architecture-designer
Command: npx skills add https://github.com/Estom/aiflex --skill architecture-designer-estom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps architects and engineering teams create, evaluate, and document system architectures so decisions are consistent, justified, and aligned with non-functional requirements.

Core Features & Use Cases

  • Architecture design & pattern selection: Recommend appropriate patterns (monolith, modular monolith, microservices, event-driven, CQRS) based on constraints and team context.
  • ADR creation and documentation: Provide ADR templates, capture trade-offs, alternatives considered, and consequences for key decisions.
  • Scalability, reliability and NFR planning: Produce high-level diagrams, NFR checklists, database and messaging recommendations, and failure-mode mitigations for cloud-native systems.
  • Use Case: Review an existing e-commerce platform and produce a migration plan to microservices with ADRs for data partitioning and service boundaries.

Quick Start

Review my system requirements and propose a high-level scalable architecture with an ADR for the primary database choice.

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 for cloud-native applications?

Scalable system architectures are designed by selecting appropriate patterns like microservices or event-driven models based on project constraints. The process produces high-level diagrams, NFR checklists, and failure-mode mitigations aligned with your availability and security requirements.

What is the best way to document architectural decisions for distributed systems?

Documenting architectural decisions involves creating Architecture Decision Records (ADRs) that capture trade-offs, alternatives considered, and consequences. This ensures key choices for distributed systems are consistent, justified, and aligned with non-functional requirements.

How do I plan a migration to microservices with proper service boundaries?

Migrating to microservices requires reviewing existing platform requirements to define service boundaries and data partitioning. This yields a structured migration plan complete with ADRs that justify the transition to a modular architecture.

When should I use event-driven architecture or CQRS over a modular monolith?

Event-driven architecture or CQRS should be used over a modular monolith when your system requires high scalability and decoupled data processing. Pattern selection depends on specific team context, project constraints, and non-functional requirements.

How do I evaluate technology choices for non-functional requirements in system design?

Evaluating technology choices for non-functional requirements involves generating an NFR checklist and analyzing failure-mode mitigations. This provides technology recommendations for databases and messaging that align with your scalability and reliability targets.