ix-architecture

ix-claude-plugin shared model

Argument parsing

Strip --save and any following path token from $ARGUMENTS before processing the scope.

• If --save <path> is present, set SAVE_PATH to that path.
• If --save is present without a path, auto-generate ix-architecture-<scope-slug>.md in cwd (scope slug = $ARGUMENTS with spaces and slashes replaced by -, or repo if arguments are empty).
• If --save is absent, SAVE_PATH is empty — do not write a file.

Health gate

Before anything else, run:

command -v ix
ix status

If either fails, stop: "ix graph unavailable — run ix docker start to start the backend, then ix status to confirm."

Then verify the graph has data:

ix subsystems --list --format llm

If the result is empty or returns an error, stop: "No graph data yet — run ix map to build the graph first."

Pro check

ix briefing --format json 2>&1

If it returns JSON with a revision field, Pro is available. Note recentDecisions for use below. Skip all [Pro] steps if it errors.

---

Phase 1 — Subsystem structure

ix subsystems --format llm

Filter results to $ARGUMENTS scope if provided (match on subsystem name or path prefix). Store the full output as SUBSYSTEMS.

Early-stop gate: Examine each region's metrics. If ALL of the following are true across every region:

• cohesion > 0.7
• coupling < 0.4
• crosscut_score ≤ 0.1 (or field absent)
• confidence ≥ 0.6

→ Report "System appears structurally healthy — no significant coupling, cohesion, or crosscutting issues detected." List subsystems with their metrics and stop. Do not proceed to Phase 2.

---

Phase 2 — Smell analysis

ix smells --format llm

Filter to scope if $ARGUMENTS was provided. Store as SMELLS.

Health gate — choose one path:

Inline path (all must be true):

• Smell count < 3
• No god-module smell present
• No smell has crosscut_score > 0.1

→ Synthesize the report inline using SUBSYSTEMS + SMELLS. Proceed to Phase 3 only if needed (see below). Skip delegation.