Senior Architect
Senior Architect provides tools and workflows for architecture design and analysis, including generating diagrams, analyzing dependencies, and assessing project structure. It helps make informed technical decisions on system design, tech stack, and architecture patterns.
✨ What it does
- Generates architecture diagrams in Mermaid, PlantUML, or ASCII from project structure.
- Analyzes dependencies for circular dependencies, coupling score, and outdated packages.
- Detects architectural patterns (MVC, layered, hexagonal) and code organization issues.
- Provides decision workflows for database selection, architecture pattern selection, and monolith vs microservices.
- Includes reference documentation for architecture patterns, system design workflows, and tech decision guides.
🎯 When to use it
- When asked to design system architecture or evaluate microservices vs monolith.
- When needing to create architecture diagrams for documentation or team discussion.
- When analyzing project dependencies for coupling, circular dependencies, or outdated packages.
- When assessing existing project structure for architectural patterns and code smells.
- When choosing a database or making technology decisions.
🚀 How to use
Trigger by asking to design system architecture, create architecture diagrams, analyze dependencies, or review system design. Provide a project directory path as input. Use the provided Python scripts with appropriate flags. Example prompts:
Generate a Mermaid component diagram for ./my-project
Analyze dependencies in ./my-project and report issues
Assess the architecture of ./my-project
📄 Output: Outputs include diagram code, dependency analysis reports, and architecture assessment reports, which can be saved to files or printed.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering-team/skills/senior-architect .claude/skills/senior-architectSkill source: engineering-team/skills/senior-architect/SKILL.md
⚠️ Good to know
Requires Python environment and project directory with supported package managers; reference documentation must be loaded for detailed guidance.
❓ FAQ
What diagram formats are supported?
The Architecture Diagram Generator supports Mermaid, PlantUML, and ASCII formats.
How do I check for circular dependencies?
Run the dependency analyzer with the --check circular flag, e.g., python scripts/dependency_analyzer.py ./project --check circular.
What does the Project Architect tool detect?
It detects architectural patterns, code organization issues like god classes, layer violations, and missing architectural components.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.