Architecture Overview

Architecture Overview

A Claude Code plugin that analyzes a project's codebase and generates a comprehensive architecture overview as a single markdown file with embedded Mermaid diagrams.

What It Does

When invoked, the plugin:

1. Explores the codebase to understand the project structure
2. Identifies architectural layers (UI, Services, Models, Infrastructure, Helpers)
3. Maps dependencies between layers
4. Generates architecture-overview.md at the project root containing:
   • A project summary
   • A layer overview diagram (top-down dependency graph)
   • Per-subsystem class diagrams
   • Layer descriptions with key files and dependencies
   • Sequence diagrams for 1-3 key data flows
5. Validates all Mermaid syntax and visually reviews rendered diagrams

Prerequisites

None. Mermaid diagrams render natively in GitHub, GitLab, VS Code, and most markdown viewers.

For syntax validation and visual review, the plugin uses @mermaid-js/mermaid-cli via npx (no pre-install required).

Installation

/plugin install architecture-overview@egamma-plugins

Usage

Ask Claude to generate an architecture overview:

• "generate an architecture overview"
• "create an architecture diagram"
• "document the system design"

You can optionally specify a focus area:

• "generate an architecture overview of the authentication subsystem"

Plugin Structure

architecture-overview/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── architecture-overview/
│       └── SKILL.md
└── README.md