architecture-overview

Architecture Overview (v2)

Generates .codeanalyzer/reports/phase4/architecture-overview.md by pulling structured data via GitNexus Cypher and narrating with LLM.

Data collection (Cypher queries)

1. Subsystem map — from .codeanalyzer/subsystems.md (already structured).
2. Module dependencies — Cypher:

   MATCH (a:Module)-[:DEPENDS_ON]->(b:Module)
   RETURN a.name, b.name
   

3. Entry-point map — from .codeanalyzer/state/entry-points.json (produced by Phase 3).
4. Subsystem coupling — for each pair of subsystems, count cross-subsystem import edges via Cypher.

Output structure

# Architecture Overview

## 1. System Purpose
<LLM narrative, 2 paragraphs, informed by phase1 summary>

## 2. Subsystem Map
<table from subsystems.md + coupling matrix>

## 3. Module Dependency Diagram
<Mermaid flowchart from dependency Cypher>

## 4. Entry Points
<list from entry-points.json>

## 5. Cross-Cutting Concerns
<LLM narrative: subsystems with unusually high coupling, bridging modules>

Rules

• Data sections (2, 3, 4) are mechanically constructed from Cypher / state JSONs.
• Narrative sections (1, 5) are LLM-authored.
• No free-form inference of structure — always query.