skills.rest
Marwan78888
Marwan78888COMMUNITY
Explore all skills by this author →
GitHub

architecture-designer

Design scalable system architectures and document decisions with ADRs.

16|Updated Apr 19, 2026
Search Tags:#architecture#scalability#adr#trade-offs#design-patterns#system-design#architecture-reviews
One-click install
npx skills add https://github.com/Marwan78888/Neuron-Cli --skill architecture-designer-marwan78888
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/Marwan78888/Neuron-Cli/tree/main/scratch/claude-skills-main/skills/architecture-designer
Command: npx skills add https://github.com/Marwan78888/Neuron-Cli --skill architecture-designer-marwan78888

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architecting complex software systems, evaluating design options, and documenting decisions to guide teams and ensure scalable, maintainable outcomes.

Core Features & Use Cases

  • Diagram high-level architectures and identify components, interactions, and data flows.
  • Create Architecture Decision Records (ADRs) to capture trade-offs, rationale, and consequences.
  • Review and improve existing designs, assess patterns, and plan for scalability and reliability.

Quick Start

Describe a new service's goals, constraints, and non-functional requirements to get a high-level architecture, ADRs, and a Mermaid diagram.

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 for a new software service?▼

To design scalable system architecture, you provide the service's goals, constraints, and non-functional requirements to generate a high-level design, identify components and data flows, and receive a Mermaid diagram.

What is an Architecture Decision Record and how does it help with trade-off analysis?▼

An Architecture Decision Record (ADR) is a document capturing key design trade-offs, rationale, and consequences. It guides teams by ensuring complex software architecture choices are evaluated and recorded for maintainable outcomes.

How do I review existing software architecture for pattern choices and scalability?▼

Reviewing existing software architecture involves assessing current design patterns, identifying component interactions, and planning for system scalability and reliability to improve and guide future development.

Can I generate a high-level architecture diagram by describing my system requirements?▼

Yes, you can generate a high-level architecture diagram by describing your new service's goals, constraints, and non-functional requirements, which produces a visual Mermaid diagram of the system design.

What is the best way to document architecture decisions for complex software?▼

The best way to document architecture decisions is by authoring Architecture Decision Records (ADRs) that detail the trade-offs, rationale, and consequences of your design patterns and scalability choices.

When do I need an architecture review for my software design?▼

You need an architecture review when evaluating design options, checking pattern choices, or planning for system scalability and reliability to ensure your complex software architecture remains maintainable.

Related Skills

Explore More Software Engineering Skills→
proyecto26proyecto26
42

requirements-scoping

Structure ambiguous system design prompts into functional requirements, non-functional constraints, and out-of-scope boundaries.

Official
Intermediate
rjroyrjroy
6

ddp

Generate Mermaid diagrams for data flows, class relationships, and architectures.

Community
Basic
PM4-SmartFinancePM4-SmartFinance

documentation-and-adrs

Record architectural decisions and design patterns in structured project documentation.

Official
Advanced
Eigo-Mt-FujiEigo-Mt-Fuji

system-architect

Design scalable, secure architectures with C4 diagrams, ADRs, and trade-off analysis.

Community
Advanced