senior-architect

Generate architecture diagrams and system design recommendations for software projects.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/JoaoPedroAmaral/backBarbearia --skill senior-architect-joaopedroamaral
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: senior-architect
Source: https://github.com/JoaoPedroAmaral/backBarbearia/tree/main/.claude/skills/senior-architect
Command: npx skills add https://github.com/JoaoPedroAmaral/backBarbearia --skill senior-architect-joaopedroamaral

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill reduces uncertainty and manual effort when designing or reviewing complex software systems by automating architecture diagram generation, dependency analysis, and producing actionable recommendations that target scalability, maintainability, and security.

Core Features & Use Cases

  • Architecture Diagram Generation: Generate structured architecture diagrams from a project path using configurable templates and built-in quality checks.
  • Project Analysis & Recommendations: Perform deep analysis to identify performance bottlenecks, anti-patterns, and provide prioritized remediation and optimization steps.
  • Dependency Analysis & Risk Assessment: Inspect dependencies for coupling, security, and licensing risks and produce concrete mitigation suggestions.
  • Use Case: Run a full architecture review on a microservices-based SaaS repository to produce diagrams, trade-off analyses, and a prioritized implementation plan.

Quick Start

Generate an architecture diagram, dependency report, and prioritized recommendations for the project located at ./myproject with verbose output.

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 a microservices project?

Generate architecture diagrams for a microservices project by providing a project path as input to produce structured diagram artifacts and written trade-off analyses. The process uses configurable templates and built-in quality checks to output visual representations of complex software systems.

What is system design dependency analysis and when do I need it?

System design dependency analysis inspects software dependencies for coupling, security, and licensing risks to produce concrete mitigation suggestions. You need this when preparing to scale web and mobile SaaS platforms or migrate multi-tenant systems to identify hidden bottlenecks and anti-patterns.

Can I use automated architecture review for multi-tenant SaaS migrations?

Automated architecture review supports multi-tenant SaaS migrations by performing deep analysis to identify performance bottlenecks and anti-patterns. It accepts a project path input and optionally emits JSON reports containing prioritized remediation and optimization steps.

What's the best way to document technology decisions and trade-offs?

The best way to document technology decisions and trade-offs is to generate written analyses that evaluate performance, security, and scalability recommendations. This approach produces actionable system design documentation and prioritized implementation plans for complex software projects.

How do I structure a scalability review for a web platform?

Structure a scalability review for a web platform by analyzing the project path to identify anti-patterns and performance bottlenecks. The review outputs prioritized remediation steps and actionable system design recommendations targeting maintainability and security.