| 1 | # TECH — тематический указатель ADR |
| 2 | |
| 3 | Здесь **нет отдельной нумерации**: нормативные решения по-прежнему лежат в родительском каталоге [`docs/adr/`](../README.md) как `NNNN-краткий-kebab-title.md`. |
| 4 | |
| 5 | Эта папка — **оглавление по теме TECH** (контракты, MCP, git core, отладка, агент, LSP, CLI контракта): быстрые ссылки, чтобы не терять контекст между обсуждением в чате и файлом в репо. |
| 6 | |
| 7 | **С чего начать (один связный текст):** [0077 — центр TECH-принципов](../0077-tech-principles-hub.md) (канон формулировок в [`../snippets/tech/`](../snippets/tech/README.md)). **Карта ссылок** по темам (без длинного текста): [principles.md](principles.md). Сборка TECH-ADR в один HTML/PDF: `dotnet script build-adr.csx --book adr-book-tech.md` — [../build/README.md](../build/README.md). |
| 8 | |
| 9 | **Канонический индекс** всего набора ADR — в [../README.md](../README.md). Политика и таблица «решение → ADR» — в [../../architecture-policy.md](../../architecture-policy.md). Операционный протокол MCP — [../../MCP-PROTOCOL.md](../../MCP-PROTOCOL.md). |
| 10 | |
| 11 | --- |
| 12 | |
| 13 | ## Указатель по TECH |
| 14 | |
| 15 | | Тема | ADR | |
| 16 | |------|-----| |
| 17 | | **Центр TECH** — вводные принципы (границы, контракты, агент, отладка); текст в [`snippets/tech/`](../snippets/tech/README.md) | [0077](../0077-tech-principles-hub.md) | |
| 18 | | Слои, срезы фич, роль `MainWindowViewModel` | [0006](../0006-presentation-layers-and-feature-slices.md) | |
| 19 | | Сигналы, слабая связность, backpressure на UI | [0007](../0007-signals-coupling-and-ui-backpressure.md) | |
| 20 | | **Шина доставки в UI** (аналогия AFDX): `Channel<T>`, батчинг; ортогонально CDS-«каналу»; журнал сборки / терминал — strangler | [0094](../0094-ingestion-bus-afdx-analogy-and-threading-channels.md) (Proposed) | |
| 21 | | **Три уровня Health:** Workspace / Solution / IDE — таксономия каналов, CDS, MCP; strangler от IDE Health | [0095](../0095-workspace-solution-ide-health-stratification.md) (Proposed) | |
| 22 | | Маршалинг UI (`IUiScheduler`, strangler) | [0004](../0004-ui-thread-marshaling.md) | |
| 23 | | Контракты MCP, тестируемая инфраструктура | [0008](../0008-mcp-contracts-and-testable-infrastructure.md) | |
| 24 | | Strangler-миграция, исключения для spike | [0009](../0009-strangler-migration-and-exceptions.md) | |
| 25 | | Отладка: паритет человек/агент | [0002](../0002-debug-human-agent-parity.md) | |
| 26 | | **Профили запуска** (несколько стартовых конфигураций, MCP, миграция с `startup-project.json`); опц. **MFD browser** для того же URL | [0090](../0090-launch-profiles-and-debug-startup-configurations.md) · [0093](../0093-mfd-embedded-browser-for-launch-url.md) (Proposed) | |
| 27 | | Debug UI отдельно от Power; гипотезы JSON; ситуационная осведомлённость | [0003](../0003-debug-ui-mode-separate-from-power.md), [0001](../0001-debug-hypotheses-json-storage.md), [0011](../0011-debug-situational-awareness.md) | |
| 28 | | Внешний агент ACP (stdio, Cursor CLI) | [0016](../0016-agent-client-protocol-external-agent.md) | |
| 29 | | Чат Cursor ACP в IDE: `mcpServers`, паритет тулов | [0048](../0048-cursor-acp-chat-ide-parity-and-mcp-tool-surface.md) | |
| 30 | | ACP: MCP IDE **в том же процессе** (loopback), не второй `CascadeIDE` | [0082](../0082-acp-ide-mcp-loopback-single-process.md) | |
| 31 | | Общий Git Core: IDE и git-mcp | [0019](../0019-shared-git-core-ide-and-git-mcp.md) | |
| 32 | | Фасад агента: провайдеры, чат, ACP, MCP | [0038](../0038-agent-facade-ai-provider-and-tool-orchestration.md) | |
| 33 | | **`[ai]` в settings.toml:** `mode` + вложенные секции (local / acp / mcp_only / cloud) | [0083](../0083-ai-mode-and-nested-settings-toml.md) | |
| 34 | | **Тема UI:** канон кистей в TOML; JSON в MCP как транспорт; strangler `Themes/*.json` | [0086](../0086-ui-theme-toml-canonical-json-mcp-wire.md) | |
| 35 | | Правки агента в редакторе как источник правды; присутствие отдельно; чат — не основной дифф | [0084](../0084-agent-edits-editor-source-of-truth-presence-channel.md) | |
| 36 | | Видимость рассуждения агента, лимиты провайдеров | [0020](../0020-agent-reasoning-visibility-and-provider-limits.md) | |
| 37 | | Навигация по workspace; MCP `get_code_navigation_context` | [0039](../0039-workspace-navigation-affordances.md) | |
| 38 | | LSP: пресеты и командная строка в `settings.toml` | [0040](../0040-lsp-launch-line-settings-toml-presets-and-environment.md) | |
| 39 | | Агент ↔ Roslyn MCP в `settings.toml` | [0058](../0058-agent-roslyn-mcp-coupling-settings-toml.md) | |
| 40 | | Профили Roslyn MCP, Manager, EFB / GlobalMap | [0059](../0059-roslyn-mcp-profiles-manager-tactical-strategic-efb.md) | |
| 41 | | MCP-транспорт: восстановление, паритет человек/агент | [0043](../0043-mcp-transport-recovery-human-agent-parity.md) | |
| 42 | | CLI контракта агента и снапшот-тесты | [0052](../0052-agent-contract-cli-and-snapshot-tests.md) | |
| 43 | | **Принципы TECH — карта канона** (таблицы «идея → ADR») | [principles.md](principles.md) | |
| 44 | | **Semantic-first** (смысл первичен; файлы/репо — проекции; не отмена git; strangler) | [0098](../0098-semantic-first-document-as-projection.md) (Proposed) | |
| 45 | |
| 46 | --- |
| 47 | |
| 48 | ## Связанные документы (не ADR) |
| 49 | |
| 50 | - [../../MCP-PROTOCOL.md](../../MCP-PROTOCOL.md) — контракты команд агента. |
| 51 | - [../../debug-human-agent-parity-v1.md](../../debug-human-agent-parity-v1.md) — операционный слой паритета отладки (если ведётся отдельно от ADR). |
| 52 | |