ix-architecture

Assess system design health from an Ix graph using ix subsystems and ix smells.

7|2|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/ix-infrastructure/ix-claude-plugin --skill ix-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ix-architecture
Source: https://github.com/ix-infrastructure/ix-claude-plugin/tree/main/skills/ix-architecture
Command: npx skills add https://github.com/ix-infrastructure/ix-claude-plugin --skill ix-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly assess system design health by identifying coupling, crosscutting concerns, code smells, and high-risk hotspots without reading source code.

Core Features & Use Cases

  • Graph-only architecture assessment: Computes cohesion, coupling, crosscut scoring, and confidence from the Ix graph rather than scanning files.
  • Smell detection and synthesis: Surfaces architecture smells (including god-module patterns) and explains severity in the context of subsystems.
  • Hotspot ranking for risky areas: Optionally ranks high-impact components based on dependents when smells or coupling indicate risk.
  • Scope analysis and optional persistence: Targets a specific subsystem or path, with an optional save output to a file for review or documentation.
  • Pro decision cross-references (optional): When Pro is available, appends recorded design decisions that relate to the findings.

Quick Start

Run ix-architecture for your repository and it will produce a graph-based architecture health report, including subsystem structure, smells, and ranked hotspots where relevant.

Frequently Asked Questions about ix-architecture

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

FAQPage Schema
How do I detect code smells and coupling risks without reading source code?

You can detect code smells and coupling risks by analyzing an Ix graph to assess subsystem structure and crosscutting signals. It computes cohesion, coupling, and smell severity without requiring direct file scanning.

What is the best way to analyze architecture health for a specific subsystem scope?

The best way to analyze architecture health is by running a scoped graph analysis on your target subsystem path. This evaluates coupling, crosscutting concerns, and architecture smells to provide early risk detection before refactoring.

How does graph reasoning identify dependency hotspots in system design?

Graph reasoning identifies dependency hotspots by ranking high-impact components based on their dependents. It highlights areas where smells or coupling indicate significant risk within the assessed subsystems.

Do I need an Ix graph available to run architecture analysis?

Yes, you need an Ix graph available to run architecture analysis. The assessment computes design health metrics and detects smells entirely from graph data rather than scanning repository files directly.

Can I save architecture health reports to a file for review?

Yes, you can optionally save architecture health reports to a file. This allows you to document subsystem structure, detected smells, and ranked hotspots for later review or team documentation.

How do I cross-reference recorded design decisions with detected architecture smells?

When Pro is present, the analysis appends recorded design decisions that relate to the findings. This cross-references your architecture smells and coupling risks with historical design decisions.