skills.rest
theandyalvarez7-ruby
theandyalvarez7-rubyCOMMUNITY
Explore all skills by this author →
GitHub

senior-architect

Analyze software architecture and generate Mermaid, PlantUML, or ASCII diagrams.

Updated Mar 5, 2026
Search Tags:#architecture#refactoring#adr#architecture-patterns#system-design#dependency-analysis#diagram-generation
One-click install
npx skills add https://github.com/theandyalvarez7-ruby/claude-skills --skill senior-architect-theandyalvarez7-ruby
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: senior-architect
Source: https://github.com/theandyalvarez7-ruby/claude-skills/tree/main/engineering-team/senior-architect
Command: npx skills add https://github.com/theandyalvarez7-ruby/claude-skills --skill senior-architect-theandyalvarez7-ruby

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Architecture design and evaluation guidance to help teams reason about complex software systems and make informed decisions.

Core Features & Use Cases

  • Architecture Diagram Generator: creates Mermaid, PlantUML, or ASCII diagrams from code projects to visualize architecture.
  • Dependency and Pattern Analysis: analyzes dependencies, coupling, and patterns to surface architecture improvements.
  • Project Architecture Review: identifies layer boundaries, code quality issues, and refactoring opportunities to improve maintainability and scalability.
  • Real-world scenarios: evaluate monolith vs modular monolith vs microservices; ADR creation and tech-stack evaluation.

Quick Start

Run an end-to-end architecture assessment on a codebase to generate pattern results and diagrams.

Frequently Asked Questions about senior-architect

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

FAQPage Schema
How do I generate architecture diagrams from an existing codebase?▼

You can generate architecture diagrams from a codebase by running an end-to-end architecture assessment. The tool analyzes your project structure and outputs Mermaid, PlantUML, or ASCII diagrams to visualize system dependencies and layer boundaries.

What is the best way to document architecture decisions for large-scale systems?▼

Documenting architecture decisions for large-scale systems is done by creating Architecture Decision Records (ADRs). This process identifies and analyzes software architecture patterns to guide design choices, tech-stack evaluation, and refactoring opportunities.

Can I analyze dependencies and coupling to evaluate monolith vs microservices architecture?▼

Yes, you can analyze dependencies and coupling to evaluate monolith versus microservices architecture. The analysis surfaces layer boundaries, code quality issues, and pattern improvements to determine maintainability and scalability across different architectural styles.

How do I perform a project architecture review to find refactoring opportunities?▼

Perform a project architecture review by analyzing your codebase to identify layer boundaries, code quality issues, and dependency patterns. This evaluation surfaces specific refactoring opportunities to improve overall system maintainability and scalability.

Does this architecture analysis tool support both Mermaid and PlantUML diagram generation?▼

Yes, the architecture analysis tool supports both Mermaid and PlantUML diagram generation, along with ASCII representations. It generates these visual outputs directly from code projects to help teams reason about complex software systems.

Related Skills

Explore More Software Engineering Skills→
manuelbrandner85manuelbrandner85

diagramming-code

Generate Mermaid diagrams from Trailmark code graphs.

Community
Intermediate
ano4lano4l

senior-architect

Document system architecture decisions with ADRs and diagrams in Mermaid, PlantUML, or ASCII.

Community
Advanced
Destynova2Destynova2
5

cli-audit-tangle

Analyze codebases for god functions, circular dependencies, dead code, and module boundaries.

Community
Advanced
GuidoBergmanGuidoBergman

create-excalidraw-diagram

Generate system architecture, ERD, and UML diagrams in Excalidraw format.

Community
Intermediate