Architect Intelligence

Enterprise architecture analysis directly in your editor. Detect anti-patterns, track score decay, get AI-powered refactoring suggestions — all without leaving VS Code.

Features

Architecture Score & Diagnostics

Run Architect: Analyze Architecture to get a full health check of your codebase. Anti-patterns appear as inline diagnostics (errors, warnings, hints) in the Problems panel and directly on affected files.

The status bar shows your live architecture score with a color-coded icon:

Green (80+) — Healthy architecture
Yellow (60-79) — Needs attention
Red (<60) — Severe issues detected

Hub Detection (Code Lens)

Files with high fan-in (many dependents) are automatically flagged with Code Lens annotations:

◉ Hub File — 12 dependents
⫸ Split this hub

Click "Split this hub" to start an interactive refactoring session that decomposes the hub into focused modules.

Forecast Overlay

Run Architect: Forecast Score Decay to predict where your architecture is heading. At-risk files get visual overlays:

Red background — Critical risk (score dropping fast)
Orange background — High risk
Yellow background — Medium risk

Hover over the annotation to see predicted scores and weekly decay rate.

Genesis Refactoring Prompts

Right-click any file → Architect: Generate Refactoring Prompt for This File to get a targeted, AI-ready prompt with specific refactoring steps for that file. Use it with Claude, GPT, or any LLM to execute the refactoring.

Interactive Refactoring

Run Architect: Interactive Refactoring to open a step-by-step terminal session that walks you through each refactoring step with previews, approvals, and automatic re-analysis after each change.

Commands

Command	Description
`Architect: Analyze Architecture`	Full analysis with diagnostics, code lens, and status bar
`Architect: Interactive Refactoring`	Step-by-step guided refactoring in terminal
`Architect: Forecast Score Decay`	ML-based prediction with visual risk overlays
`Architect: Open Genesis Terminal`	Interactive Genesis TUI for advanced refactoring
`Architect: Generate Refactoring Prompt`	Right-click context menu — AI-ready prompt for a file
`Architect: Show Anti-Patterns`	Navigable list of all detected anti-patterns
`Architect: List Plugins`	Show installed Architect plugins

Settings

Setting	Default	Description
`architect.autoAnalyzeOnOpen`	`false`	Auto-analyze when opening a workspace
`architect.analyzeOnSave`	`false`	Re-analyze on every file save
`architect.hubThreshold`	`5`	Minimum dependents to flag a file as a Hub

Supported Languages

TypeScript, JavaScript, Python, Go, Rust, Java.

Requirements

The extension uses the Architect CLI under the hood. It is automatically installed via npx on first use — no manual setup required.

For the best experience, install the CLI globally:

npm install -g @girardelli/architect

About

Built by Girardelli Tecnologia. Architecture analysis powered by AST parsing, dependency graph analysis, and ML-based forecasting.

License: MIT