ADR map: how to read CascadeIDE architecture (v1)¶

This document answers: which ADRs to read to understand the system — by topic and by role.
It does not replace the ADR index: ../adr/README.md.
Current architecture “as is” — current-architecture-v1.md.

1. Where to start (fast route)¶

Layers and boundaries: 0006
Data flow and cockpit (CDS): 0036
IDE overlay domain (IDS), separate from CDS: 0079
MCP contracts and testable infrastructure: 0008
Code navigation / navigation MCP: 0039

If you are reading for “how Flight UI is laid out today”, start with the layout doc, not ADR: - ../ui-ux/cascade-ide-ui-layout-v1.md

2. UI and attention model (PFD / Forward / MFD)¶

Attention model and PFD/MFD terminology: 0021 (Proposed, but sets the language)
Layout invariants and presentation authority: 0046 (Accepted · Implemented)
Multi-window and surfaces: 0017 (Accepted · Implemented)
Remote operator surface from another device (not mobile IDE): 0117 (Proposed)
Agent Notes Core 2.0 (TOML, knowledge_path, MCP parity): 0118 (Accepted)

3. MVVM, feature slices, and “what lives where”¶

Slices and layers: 0006
Strangler migration and exceptions: 0009

4. Transport / backpressure / delivery to UI¶

Signals, coupling, backpressure: 0007
UI thread marshaling: 0004
Delivery bus (AFDX analogy): 0094

5. DAL / CCU / DataBus (pipeline “raw → DTO → UI”)¶

DAL boundary: 0102
CCU as fold layer: 0097
CDS (channel → compositor → surface): 0036
Graph-backed instruments — shared layer inside CDS: 0115 (Accepted)
IDE DataBus: 0099
Health stratification: 0095 (if you need “what IDE/Solution/Workspace health means”)

6. MCP, agent, and contract testability¶

MCP contracts + testable infrastructure: 0008
Agent contract CLI + snapshot tests: 0052
Visibility of reasoning / provider limits: 0020
Intercom (channel, not “chatbot”): 0080
Topic cards + spine (topic card index): 0072, 0096
Session tree, steer / follow-up: 0116 (Proposed)
Chat persistence (event log): 0045
Clarification batches and threads: 0031

Workspace navigation affordances: 0039
Hybrid codebase index core: 0105 (Accepted · Implemented)
Hybrid index ↔ CascadeIDE integration: 0106
HCI and Semantic Map (orientation, three axes): 0113
Edge relation type (relation_kind): 0114
Graph kinds (graph_kind) and instrument categories: 0065
Graph-backed surfaces (graph family contract): 0067
Semantic map control flow (PFD): 0053 (Accepted · Implemented)

8. Commands and keyboard-first¶

Command surface & discoverability: 0013
Command palette direct overlay: 0070
Chord stack (Ctrl+K) / FMS-style: 0060

9. Where to keep “current architecture” description¶

ADR records decisions and motivation. For “how it works now” use: - docs/en/architecture/current-architecture-v1.md (canonical entry — this tree) - docs/en/ui-ux/cascade-ide-ui-layout-v1.md (layout / region names reference) - docs/MCP-PROTOCOL.md (MCP contract reference)

Version: v1.