senior-architect

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

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/tapanshah/Claude-Skills --skill senior-architect-tapanshah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: senior-architect
Source: https://github.com/tapanshah/Claude-Skills/tree/main/engineering-team/senior-architect
Command: npx skills add https://github.com/tapanshah/Claude-Skills --skill senior-architect-tapanshah

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mermaid, plantuml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides tools and guidance for designing robust system architectures, evaluating technical decisions, and analyzing project dependencies to ensure scalability and maintainability.

Core Features & Use Cases

  • Architecture Diagram Generation: Visualize system components and layers using Mermaid, PlantUML, or ASCII.
  • Dependency Analysis: Identify circular dependencies, assess coupling, and detect outdated packages.
  • Architecture Assessment: Detect architectural patterns and code smells within a project.
  • Decision Workflows: Step-by-step guides for choosing databases, architecture patterns, and making technology decisions.
  • Use Case: When tasked with designing a new microservices-based e-commerce platform, use this skill to generate an initial architecture diagram, analyze potential dependency issues between services, and follow the workflow for selecting the most appropriate database technology.

Quick Start

Use the senior-architect skill to generate a component diagram for the current project directory in Mermaid format.

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 for my existing project structure?

Generate architecture diagrams by analyzing your project structure to produce component, layer, and deployment diagrams in Mermaid, PlantUML, or ASCII format. The skill uses Python scripts to map out system dependencies and architectural patterns automatically.

How can I detect circular dependencies and high coupling in my codebase?

Detect circular dependencies and high coupling by running an automated dependency analysis on your project. This process assesses code quality, identifies architectural patterns, and highlights potential structural issues like large files or outdated packages.

Does this tool provide workflows for choosing a database for microservices?

Yes, it provides step-by-step decision workflows for selecting appropriate database technologies and architecture patterns. These guides help evaluate technical decisions specifically for designing scalable microservices platforms.

Can I use Mermaid and PlantUML together for system design visualization?

Yes, you can use Mermaid and PlantUML together for system design visualization. The tool supports generating component, layer, and deployment diagrams across both formats, plus ASCII, from a single project analysis.

What is the best way to assess architectural patterns and code smells?

The best way to assess architectural patterns and code smells is to automate the analysis of project dependencies and file sizes. This identifies structural issues, high coupling, and circular dependencies to ensure system maintainability.