Oop Architect

OOP Architect

English | [中文](README.zh.md)

A [Claude Code](https://claude.ai/code) skill that designs, documents, and tracks object-oriented software architecture using live Mermaid UML diagrams inside `CLAUDE.md`.

What It Does

When you start or return to a project, you need to instantly understand: what's built, what's in progress, how things connect, and what constraints exist. This skill turns `CLAUDE.md` into a self-maintaining architecture blueprint — updated automatically as you code.

Four Modes

Situation	What happens
New project, no code yet	Design class hierarchy from scratch, generate CLAUDE.md
Existing code, no CLAUDE.md	Scan code and reverse-generate architecture documentation
Existing project, adding a feature	Design new components on top of the existing architecture
Code has drifted from CLAUDE.md	Full resync — scan code and update all diagrams

What Gets Generated

• Class diagrams with full typed signatures, visibility markers (+ - #), and per-class implementation status (✅ complete / 🔶 partial / 🔲 not started)
• Sequence diagrams for key workflows (auth, request lifecycle, etc.)
• Component diagrams for multi-module projects
• State diagrams for entities with explicit lifecycle or status transitions
• ER diagrams for data-heavy projects with ORM or non-trivial data models
• Progress table, directory structure, design decisions, and constraint notes
• Embedded maintenance rules so CLAUDE.md stays current on its own — no skill activation needed for routine updates

Language Support

Python · Java · C# · Kotlin · TypeScript · JavaScript · Go · Rust · C++ · Swift · Ruby · PHP · Generic OOP fallback

---

Install

**Via Claude Code marketplace** (recommended):

claude plugin marketplace add ZhongliangGuo/oop-architect
claude plugin install oop-architect@oop-architect

**Per-project** (committed to the repo):

git clone https://gi