architecture-designer

Design, review, and document system architecture with ADRs.

10|3|Updated Mar 14, 2025
One-click install
npx skills add https://github.com/Mentor-Wizard/mentor-wizard-webapp --skill architecture-designer-mentor-wizard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/Mentor-Wizard/mentor-wizard-webapp/tree/main/.claude/skills/architecture-designer
Command: npx skills add https://github.com/Mentor-Wizard/mentor-wizard-webapp --skill architecture-designer-mentor-wizard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill assists in the creation, review, and decision-making processes for system architecture, ensuring robust, scalable, and maintainable designs.

Core Features & Use Cases

  • System Design: Architect new systems from scratch, considering functional and non-functional requirements.
  • Architecture Review: Evaluate existing designs for potential improvements, bottlenecks, or security vulnerabilities.
  • Decision Documentation: Create Architecture Decision Records (ADRs) to formally document significant architectural choices and their rationale.
  • Use Case: When building a new microservices-based e-commerce platform, use this Skill to define the core services, their interactions, database choices, and document these decisions using ADRs.

Quick Start

Design a scalable architecture for a new social media application, focusing on user authentication and content delivery.

Frequently Asked Questions about architecture-designer

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

FAQPage Schema
How do I design a scalable system architecture for a new application?

To design scalable system architecture, define functional and non-functional requirements first, then apply established design patterns to structure core services and their interactions. This ensures robust and maintainable software systems.

What is an Architecture Decision Record and when should I create one?

An Architecture Decision Record (ADR) formally documents significant technical design choices and their rationale. Create ADRs during system design to capture context, decisions, and consequences for complex software architecture.

How do I review existing system design for bottlenecks and security vulnerabilities?

Review existing system design by evaluating current architecture patterns against best practices to identify potential bottlenecks, security vulnerabilities, and scalability limitations. This process highlights areas for architectural improvement.

What's the best way to document technical design decisions for a microservices platform?

The best way to document technical design for microservices is creating ADRs for each significant choice. Document core services, database selections, and interaction patterns to maintain a clear architectural rationale.

When should I not use established architecture patterns for system design?

Avoid forcing established architecture patterns when non-functional requirements strictly dictate a unique, unconventional system design. Over-applying patterns to simple workflows can introduce unnecessary complexity and bottleneck scalability.

Can I use this approach to plan scalability for complex software systems?

Yes, you can use architectural design guidance to plan scalability for complex software systems. It facilitates evaluating non-functional requirements and applying appropriate design patterns to handle increased load effectively.