architecture-designer

Convert enterprise requirements into system architecture with Mermaid diagrams and ADRs.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill architecture-designer-enigmaicon-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/enigmaicon-eng/AI-Enterprise-OS/tree/main/examples/claude-skills/skills/architecture-designer
Command: npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill architecture-designer-enigmaicon-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architecture Designer helps you turn ambiguous requirements into a coherent, maintainable system design by making explicit decisions, trade-offs, and scalability considerations before implementation starts.

Core Features & Use Cases

  • High-level architecture and diagrams: Produce a clear component interaction view (Mermaid diagrams) to align stakeholders on structure and data flow.
  • ADRs (Architecture Decision Records): Document key architectural choices with context, alternatives, consequences, and trade-offs to preserve rationale over time.
  • Architecture review and planning: Evaluate existing designs, refine patterns (e.g., monolith vs microservices), and plan for scalability and operational complexity.

Quick Start

Use architecture-designer to create a system architecture diagram and a set of ADRs for a new microservices-based platform based on your functional and non-functional requirements.

Frequently Asked Questions about architecture-designer

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

FAQPage Schema
How do I document system design trade-offs for a microservices architecture?

You can document microservices trade-offs by generating Architecture Decision Records (ADRs) that capture context, alternatives, and consequences, alongside Mermaid diagrams to visualize component interactions and data flow.

What is the best way to create architecture diagrams from functional requirements?

Creating architecture diagrams from requirements involves translating enterprise needs into Mermaid-based component views, ensuring structural alignment and clear data flow representation for stakeholders before implementation begins.

How do I write an Architecture Decision Record that includes non-functional requirements?

Writing an ADR with non-functional requirements involves structuring the document to explicitly state constraints, failure modes, security considerations, and the rationale behind specific technology trade-offs.

Can I use this approach to evaluate a monolith versus microservices for scalability planning?

Yes, you can evaluate a monolith versus microservices by reviewing existing designs, comparing operational complexity, and applying scalability planning to determine the most suitable architecture pattern.

When do I need to define failure modes and security considerations in system design?

You need to define failure modes and security considerations during architecture design and review phases to ensure operational resilience and address explicit constraints before system implementation starts.

How do I structure an event-driven system design with explicit technology trade-offs?

Structuring an event-driven system design involves mapping component interactions with Mermaid diagrams and documenting explicit technology trade-offs and scalability considerations in ADR-style records.