AI Architecture Review Board

"The most expensive software and system defects originate during the early architecture and design phase, rather than coding."

A VS Code extension that runs a structured, multi-agent architecture review inside your editor. Describe a system you want to build, and a panel of specialist AI architects independently design, debate, score, and critique each other's proposals — finishing with a Chief Architect recommendation, risk register, and implementation roadmap.

Table of Contents

1. Why This Extension
2. The Tension Triangle
3. Key Features
4. Installation
5. The Seven Stages
6. Running the Extension
7. UI Overview

Why This Extension

Most architecture decisions are made by a single person or a small team with a narrow perspective. The AI Architecture Review Board simulates a real senior review panel: specialist architects with deliberately different domains independently design a solution, then spend multiple rounds critiquing and scoring each other's work.

The extension starts by understanding the problem through follow-up questions. Once requirements are finalized, three specialized AI architects — Scalability, Security, and Cost & Operations — independently generate architecture proposals in parallel. Each architect then evaluates all proposals, identifies risks, challenges design decisions, and scores the alternatives. In subsequent debate rounds, all identified risks are discussed again, allowing architects to challenge each other's assumptions and refine their recommendations. The process continues until no new risks are discovered.

The goal is to provide a structured second opinion for architecture decisions and identify risks and trade-offs early — before they become expensive to fix. Everything runs inside VS Code. No external tools. No browser tab. No API key beyond a standard GitHub Copilot subscription.

The Tension Triangle

The three architect specializations create a deliberate tension during reviews:

• Scalability vs. Cost — balancing over-engineering with the right level of capacity and performance.
• Security vs. Cost — security controls such as WAF, Vault, and key rotation come with real cost implications.
• Security vs. Scalability — measures like zero-trust and mTLS can introduce latency and impact throughput.

This tension is productive. A single reviewer optimises for their own lens; three specialists with competing priorities surface the trade-offs that would otherwise stay hidden until production.

Key Features

• Requirement clarification before starting the review — up to three rounds of follow-up questions to freeze a precise problem statement.
• Three specialized AI architects (Scalability, Security, Cost & Operations) working in parallel.
• Three independent architecture proposals, each covering recommended components, topology, and reasoning.
• Multi-round debate — architects score and critique all proposals, with rounds continuing until no new risks surface.
• Chief Architect recommendation — final synthesis with confidence score, ADRs, implementation roadmap, and a Mermaid architecture diagram.
• Risk register — structured risk entries with severity (High / Medium / Low) and mitigations, deduplicated across rounds.
• Live progress and outputs directly inside VS Code — no browser tab, no external dashboard.

Installation

From the VS Code Marketplace (recommended)

1. Open VS Code.
2. Press Ctrl+Shift+X (or Cmd+Shift+X on macOS) to open the Extensions view.
3. Search for AI Architecture Review Board.
4. Click Install.
5. Once installed, the extension icon appears in the Activity Bar on the left. Click it to open the review panel.

Requirements: VS Code 1.90.0 or later and an active GitHub Copilot subscription.

The Seven Stages

Stage 1  ─  Requirement Input
Stage 2  ─  Requirement Clarification
Stage 3  ─  Proposals Generation
Stage 4  ─  Debate Rounds
Stage 5  ─  Debate Summary
Stage 6  ─  Chief Review
Stage 7  ─  Reports

Running the Extension

1. After installation, click the AI Architecture Review Board icon in the Activity Bar (left sidebar).
2. Click Start Review in the panel.
3. Describe the system you want to review — the extension will ask follow-up questions to clarify requirements.
4. Once requirements are finalised, the three architects generate proposals in parallel.
5. Watch the debate rounds run automatically; the Chief Architect delivers the final recommendation when consensus is reached.