senior-architect

Generates architecture diagrams and analyzes project dependencies, patterns, and layer violations.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/Tgoldi/claude-skills --skill senior-architect-tgoldi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: senior-architect
Source: https://github.com/Tgoldi/claude-skills/tree/main/senior-architect
Command: npx skills add https://github.com/Tgoldi/claude-skills --skill senior-architect-tgoldi

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Making sound architecture decisions requires understanding your current codebase structure, dependencies, and patterns, but manually auditing large projects is slow and error-prone. This Skill automates architecture assessment, diagram generation, and dependency analysis so you can make informed technical decisions quickly. ## Core Features & Use Cases - Architecture Diagram Generation: Scans a project directory and produces component, layer, or deployment diagrams in Mermaid, PlantUML, or ASCII format. - Dependency Analysis: Parses package.json, requirements.txt, pyproject.toml, go.mod, or Cargo.toml to detect circular dependencies, compute a coupling score, and flag problematic packages. - Architecture Assessment: Detects architectural patterns (layered, MVC, hexagonal, clean, microservices), finds god classes and oversized files, and reports layer violations with recommendations. - Decision Workflows: Provides structured guidance for database selection, monolith vs microservices decisions, and architecture pattern selection, plus reference docs on 9 architecture patterns. - Use Case: Before proposing a microservices migration, run the project architect on your monolith to detect its current pattern, identify layer violations and god classes, then generate a Mermaid component diagram to present findings to the team. ## Quick Start Ask the assistant to analyze the architecture of your project directory and generate a Mermaid component diagram along with a dependency and layer-violation report.

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 codebase?

Run the architecture diagram generator script against your project directory to produce component, layer, or deployment diagrams. It supports Mermaid, PlantUML, and ASCII output formats and detects components, relationships, and technologies automatically.

How to detect circular dependencies in a project?

The dependency analyzer scans internal module imports and builds a dependency graph, then uses depth-first search to find cycles. It reports each circular chain and adds a penalty to the coupling score, with recommendations to extract shared interfaces.

Which package managers does the dependency analyzer support?

It supports npm and yarn via package.json, pip via requirements.txt, Poetry via pyproject.toml, Go via go.mod, and Rust via Cargo.toml. It parses direct and dev dependencies from each manifest format.

When should I choose microservices over a monolith?

Choose microservices when teams can own services end-to-end, independent deployment is critical, and components have different scaling needs. For small teams or unclear domain boundaries, start with a modular monolith and extract services only when scaling or deployment needs demand it.

What architectural patterns can the project architect detect?

It detects layered, MVC, hexagonal, clean, microservices, modular monolith, and feature-based patterns by scoring directory structures and file names against pattern signatures. It reports a confidence percentage and flags layer violations and god classes.

What are the limitations of automated architecture analysis?

Detection relies on directory naming conventions and import statements, so unconventional structures may yield low confidence scores or missed relationships. Outdated package detection is basic and does not query live registries for the latest versions.