system-architect

Generate architectural plans, ADRs, and C4 model diagrams in Mermaid syntax.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/brenordv/claude-skill-set --skill system-architect-brenordv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/brenordv/claude-skill-set/tree/main/skills/system-architect
Command: npx skills add https://github.com/brenordv/claude-skill-set --skill system-architect-brenordv

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill addresses the complexity of system design by providing a structured, repeatable framework for architectural decision-making, ensuring that technical choices are well-reasoned, documented, and aligned with project constraints.

Core Features & Use Cases

  • Architectural Documentation: Generates ADRs, system design documents, and implementation roadmaps using a standardized, human-centric voice.
  • Visual Modeling: Produces C4 model diagrams (Context, Container, Component) using Mermaid syntax to clarify system boundaries and data flows.
  • Decision Support: Provides a pattern selection decision tree and trade-off analysis framework to help teams choose between monoliths, microservices, and other architectural styles based on scale and team expertise.

Quick Start

Use the system-architect skill to draft an architecture decision record for the proposed database migration strategy.

Frequently Asked Questions about system-architect

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

FAQPage Schema
How do I generate an architectural decision record for a database migration strategy?

The skill produces architectural decision records by applying a structured, repeatable framework to your database migration strategy. It generates standardized ADRs using a human-centric voice, ensuring technical choices are well-reasoned, documented, and aligned with project constraints.

How do I create C4 model diagrams for system design using Mermaid?

You create C4 model diagrams by providing your system design details to the skill. It produces Context, Container, and Component diagrams using Mermaid syntax to clarify system boundaries and data flows within your software projects.

What's the best way to choose between monolith and microservices architecture?

Use the skill's pattern selection decision tree and trade-off analysis framework to choose between monoliths, microservices, and other architectural styles. It evaluates options based on your specific scale and team expertise constraints.

Can I use this for technology selection during technical design phases?

Yes, the skill applies to technical design phases and technology selection. It produces architectural plans and system design documentation, applying a structured framework to ensure your technical choices are well-reasoned and documented.

Do I need to follow C4 modeling standards for system design documentation?

Yes, the skill requires adherence to C4 modeling standards when producing system design documentation. It ensures rigorous citation of external technology documentation and generates standardized Context, Container, and Component diagrams.

Why does system design require rigorous citation of external technology documentation?

Rigorous citation of external technology documentation ensures that technical choices in system design are well-reasoned and aligned with project constraints. The skill enforces this standard to maintain the quality and verifiability of architectural plans.