ADR map: как читать архитектуру CascadeIDE (v1)¶
Этот документ отвечает на вопрос: “какие ADR читать, чтобы понять систему” — по темам и по роли.
Он не заменяет индекс ADR: docs/adr/README.md.
Текущее состояние архитектуры “как есть” — current-architecture-v1.md.
1. С чего начать (быстрый маршрут)¶
- Слои и границы:
0006 - Поток данных и “кабина” (CDS):
0036 - Overlay-домен IDE (IDS), отдельно от CDS:
0079 - MCP контракты и тестируемая инфраструктура:
0008 - Навигация по коду / MCP навигации:
0039
Если ты читаешь это ради “как сейчас устроен UI Flight”, начни не с ADR, а с layout doc:
- docs/ui-ux/cascade-ide-ui-layout-v1.md
2. UI и модель внимания (PFD / Forward / MFD)¶
- Модель внимания и терминология PFD/MFD:
0021(Proposed, но задаёт язык) - Инварианты раскладки и authority
presentation:0046(Accepted · Implemented) - Мультиоконность и поверхности:
0017(Accepted · Implemented) - Пульт оператора с другого устройства (не mobile IDE):
0117(Proposed) - Agent Notes Core 2.0 (TOML,
knowledge_path, паритет с MCP):0118(Accepted)
3. MVVM, срезы фич и “что где живёт”¶
4. Transport / backpressure / доставка в UI¶
5. DAL / CCU / DataBus (pipeline “сырьё → DTO → UI”)¶
- DAL boundary:
0102 - CCU как слой свёртки:
0097 - CDS (канал → композитор → поверхность):
0036 - Graph-backed приборы — общий слой внутри CDS:
0115(Accepted) - IDE DataBus:
0099 - Health stratification:
0095(если интересует “что такое IDE/Solution/Workspace health”)
6. MCP, агент и тестируемость контрактов¶
- MCP contracts + testable infrastructure:
0008 - Agent contract CLI + snapshot tests:
0052 - Visibility of reasoning / provider limits:
0020 - Intercom (канал, не «чат-бот»):
0080 - Topic cards + spine (картотека тем):
0072,0096 - Дерево сессии, steer / follow-up:
0116(Proposed) - Persistence чата (event log):
0045 - Пакеты уточнений и треды:
0031
7. Навигация по коду и индексация¶
- Workspace navigation affordances:
0039 - Hybrid codebase index core:
0105(Accepted · Implemented) - Integration Hybrid index ↔ CascadeIDE:
0106 - HCI и Semantic Map (ориентация, три оси):
0113 - Тип отношения на ребре (
relation_kind):0114 - Типы графов (
graph_kind) и категории инструментов:0065 - Graph-backed surfaces (контракт семейства графов):
0067 - Semantic map control flow (PFD):
0053(Accepted · Implemented)
8. Команды и keyboard-first¶
- Command surface & discoverability:
0013 - Command palette direct overlay:
0070 - Chord stack (Ctrl+K) / FMS-style:
0060
9. Где держать “описание текущей архитектуры”¶
ADR фиксируют решения и мотивацию. Для “как сейчас” держим:
- docs/architecture/current-architecture-v1.md (эталонная точка входа)
- docs/ui-ux/cascade-ide-ui-layout-v1.md (эталон layout/имена регионов)
- docs/MCP-PROTOCOL.md (эталон контракта MCP)
Версия: v1.