architecture

Analyzes hexagonal architecture compliance, generates diagrams, and creates Architecture Decision Records.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/geekatron/jerry-claude-plugin --skill architecture-geekatron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/geekatron/jerry-claude-plugin/tree/main/skills/architecture
Command: npx skills add https://github.com/geekatron/jerry-claude-plugin --skill architecture-geekatron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining consistent system design is hard: layer boundaries erode, architectural decisions go undocumented, and design reviews lack a repeatable checklist. This Skill enforces hexagonal architecture rules, documents decisions as ADRs, and reviews designs against DDD, SOLID, and ports-and-adapters principles. ## Core Features & Use Cases - Compliance Analysis: Verify that the domain layer has no external dependencies and that imports flow inward across interface, infrastructure, application, and domain layers. - Diagram Generation: Produce hexagonal, component, sequence, and data-flow diagrams in Mermaid, PlantUML, or ASCII formats. - Design Review & ADRs: Review design documents against hexagonal, DDD, or SOLID checklists and create Architecture Decision Records in docs/design/. - Use Case: Before merging a new authentication module, run an architecture review against the hexagonal checklist, then document the chosen token strategy as an ADR for future auditors. ## Quick Start Ask the assistant to analyze the src/domain directory for hexagonal architecture compliance and report any layer dependency violations.

Frequently Asked Questions about architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check hexagonal architecture compliance in my codebase?▼

Run the analyze command on a component path, such as the domain directory, to verify layer boundaries. It checks that the domain layer has no external imports and that dependencies point inward, reporting pass or fail per check.

How do I create an Architecture Decision Record?▼

Invoke the decision command with a title, such as a persistence or framework choice. It creates a structured ADR file in docs/design with context, decision, consequences, and alternatives sections, with status options like proposed or accepted.

What diagram formats does the architecture skill support?▼

It generates hexagonal, component, sequence, and data-flow diagrams in Mermaid, PlantUML, or ASCII formats. Mermaid is the default, and output can go to the console or a specified file path.

When should I use problem-solving instead of architecture review?▼

Use problem-solving for root cause analysis and debugging, since architecture commands produce structural design artifacts rather than causal chains. Architecture review is for validating designs against hexagonal, DDD, and SOLID checklists.

What layer dependency rules does hexagonal architecture enforce?▼

The domain layer may only use the standard library with no external imports. Application may import domain only, infrastructure may import domain and application, and the interface layer may import all layers.