skills.rest
ericgandrade
ericgandradeCOMMUNITY
Explore all skills by this author →
GitHub

senior-solution-architect

Analyze current systems to propose scalable architectures and formal decision records.

65|11|Updated Feb 1, 2026
Search Tags:#architecture#adr#patterns#software-engineering#system-design#design-review#c4-model
One-click install
npx skills add https://github.com/ericgandrade/claude-superskills --skill senior-solution-architect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: senior-solution-architect
Source: https://github.com/ericgandrade/claude-superskills/tree/main/skills/senior-solution-architect
Command: npx skills add https://github.com/ericgandrade/claude-superskills --skill senior-solution-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams analyze, design, and document complex software architectures with rigorous, decision-focused workflows.

Core Features & Use Cases

  • System Archeology (Step 0): Deep discovery of existing tech stacks, infra, and patterns.
  • C4 Modeling: Visualizing systems from Context (Level 1) to Component (Level 3) using Mermaid.
  • Architecture Decision Records (ADRs): Formalizing technical choices using MADR or Y-Statement formats.
  • Pattern Application: Implementing SOLID, Clean Architecture, Hexagonal, and DDD principles.
  • Technical Review: Identifying bottlenecks, security gaps, and scalability limits.

Quick Start

Start by outlining the current system, then generate a C4 model and ADRs to guide the design decisions.

Frequently Asked Questions about senior-solution-architect

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

FAQPage Schema
How do I create a C4 model for an existing software system?▼

Generate Architecture Decision Records by formalizing technical choices using MADR or Y-Statement formats to document software engineering decisions and ensure rigorous governance across complex tech stacks.

What is the best way to document software architecture decisions for a migration plan?▼

Document software architecture decisions by generating Architecture Decision Records using formal MADR or Y-Statement formats to rigorously track technical choices and govern migration planning.

Can I use SOLID and DDD patterns when conducting an architecture design review?▼

Yes, you can apply SOLID, Clean Architecture, Hexagonal, and DDD patterns during technical reviews to identify bottlenecks, security gaps, and scalability limits across complex software systems.

How do I analyze a current system to propose scalable software architectures?▼

Perform System Archeology to deeply discover existing tech stacks, infrastructure, and patterns, then analyze the findings to propose scalable software architectures and formal decision records.

When do I need to use Y-Statement ADRs instead of MADR format?▼

Use Y-Statement or MADR formats to formalize technical choices when documenting architecture decisions. Both structures capture context and consequences to guide rigorous software design reviews.

Related Skills

Explore More Software Engineering Skills→
CarbeneAICarbeneAI
9

senior-architect

Design scalable software architectures with diagrams, tech stacks, and integration patterns.

Community
Advanced
jikig-aijikig-ai
12

architecture

Create, manage, and query ADRs and Mermaid C4 diagrams.

Official
Advanced
bRRRITSCOLDbRRRITSCOLD
2

architecture

Design and review software architecture with C4 diagrams and ADRs.

Community
Advanced
ramonclaudioramonclaudio
4

audit

Audit a repository for architecture, bugs, and security findings with fix proposals.

Community
Advanced