senior-architect

Generate Mermaid architecture diagrams and analyze project dependencies with Python scripts.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Qcasares/saas-app --skill senior-architect-qcasares
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: senior-architect
Source: https://github.com/Qcasares/saas-app/tree/main/skills/senior-architect
Command: npx skills add https://github.com/Qcasares/saas-app --skill senior-architect-qcasares

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mermaid, plantuml, python, pdf, yaml, json, csv, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a comprehensive toolkit for designing, analyzing, and documenting system architecture. It helps with decision-making, dependency analysis, and visualization.

Core Features & Use Cases

  • Architecture Diagram Generation: Create diagrams in multiple formats (Mermaid, PlantUML, ASCII) to visualize system architecture.
  • Dependency Analysis: Detect circular dependencies, analyze coupling, and identify outdated packages.
  • Project Assessment: Assess project structure and detect architectural patterns, code smells, and improvement opportunities.
  • Decision Workflows: Guides for choosing databases, evaluating architecture patterns, and deciding between monolithic and microservices.
  • Reference Documentation: Access detailed information on architecture patterns, system design workflows, and tech stack coverage.
  • Tech Stack Coverage: Provides information on supported languages, frameworks, databases, and infrastructure tools.

Quick Start

Generate an architecture diagram from the current project directory using the following command:

python scripts/architecture_diagram_generator.py . --format mermaid

Frequently Asked Questions about senior-architect

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

FAQPage Schema
How do I generate an architecture diagram from my existing project directory?

To generate an architecture diagram, run the Python architecture diagram generator script against your project path, specifying the desired output format such as Mermaid or PlantUML to visualize the system structure.

How can I detect circular dependencies and analyze project coupling?

Detecting circular dependencies and analyzing project coupling involves running the automated dependency analysis Python scripts, which evaluate your codebase to identify tightly coupled modules and outdated packages.

Can I use this to get decision support for choosing between a monolithic and microservices architecture?

Yes, you can use the built-in decision workflows to evaluate architecture patterns, providing structured guides for choosing databases and deciding between monolithic and microservices structures.

What Python dependencies are required to run system assessment and diagram generation?

Running system assessment and diagram generation requires Python along with specific libraries for Mermaid, PlantUML, and dependency analysis to ensure proper script execution and output rendering.

Does this tool support exporting architectural diagrams in formats other than Mermaid?

Yes, the architecture diagram generator supports multiple visualization formats including Mermaid, PlantUML, and ASCII, allowing you to render system structures in your preferred diagramming format.

What is the best way to assess my project structure for architectural patterns and code smells?

Assessing project structure for architectural patterns and code smells is best handled by the project assessment Python scripts, which analyze your directories to detect patterns and identify improvement opportunities.