senior-architect

Generates architecture diagrams, analyzes dependencies, and assesses project structure for technical decisions.

2|1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/bhaktofmahakal/ai-counsellor-hf --skill senior-architect-bhaktofmahakal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: senior-architect
Source: https://github.com/bhaktofmahakal/ai-counsellor-hf/tree/main/.claude/skills/senior-architect
Command: npx skills add https://github.com/bhaktofmahakal/ai-counsellor-hf --skill senior-architect-bhaktofmahakal

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, dependency health, and which patterns fit your requirements, but manually auditing projects and comparing options is slow and error-prone. ## 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 patterns like layered, MVC, hexagonal, or microservices, finds god classes and oversized files, and reports layer violations with recommendations. - Decision Workflows: Provides structured guidance for database selection, monolith vs microservices, and pattern selection, backed by reference docs on 9 architecture patterns. - Use Case: Before proposing a refactor, run the project architect script on your repository to get a pattern detection report with confidence score, then generate a Mermaid layer diagram to share with your team. ## Quick Start Analyze the architecture of my project in the current directory and generate a Mermaid component diagram showing its modules and dependencies.

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 with your project path and choose a format: Mermaid, PlantUML, or ASCII. It scans directories, detects components and their import relationships, and outputs component, layer, or deployment diagrams.

How to detect circular dependencies in a project?▼

Use the dependency analyzer script with the --check circular flag. It builds a module dependency graph from import statements and runs depth-first search to find cycles, reporting each circular chain it discovers.

What package managers does dependency analysis support?▼

The analyzer 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 auto-detects which package manager a project uses.

When should I choose microservices over a monolith?▼

Choose microservices when teams can own services end-to-end, independent deployment is critical, and domain boundaries are well understood. Start with a modular monolith for small teams or unclear boundaries, extracting services only when scaling or deployment needs diverge.

What are the limitations of automated architecture detection?▼

Pattern detection relies on directory and file naming conventions, so unconventional structures may yield low confidence scores or an unstructured classification. Import-based relationship detection is heuristic and may miss dynamic or indirect dependencies.