ADR 0174: SEDM — Software Engineering Decision Making (операционная модель и UX spine)

Статус: Proposed
Дата: 2026-07-12

Резюме

Semantic Map и Correspondence в CIDE задуманы как ориентация док↔код, но в UX сегодня ближе к инженерной демке (subgraph, слои L0–L4, MFD-страница), чем к ответу оператора: «что мы делаем, зачем я в этом файле, чем проверить».

SEDM (Software Engineering Decision Making) — именованная операционная модель принятия инженерных решений в agentic-контуре. От SEDM выводится UX (плотность, Surface vs Instrument), а не наоборот.

Эмпирическая база (Tao I-1…I-15, Al Safwan, CRDM, FAA ADM) — KB kb-cide-sdm-decision-making-research-v1 (agent-notes); research-имя SDM сохраняется, продуктовый spine — SEDM.

Принято направление (концепт):

1. Фазы SEDM задают, какие вопросы показывать оператору и агенту, не смешивая фазы на одном экране.
2. Лестница артефактов T0–T4: реплика → intent card → context card → KB → ADR.
3. Conversation-first 0172: Perceive + Perform на Surface (Intercom, scope strip); SM/CRS — Process engines и drill-down, не default.
4. Context card (T2) — Perceive-снимок для файла/attach; заменяет «L0–L4 в лицо» как первый экран.

Связанные ADR

Вне ADR

Контекст

IOP без операционной модели

IOP 0121 задаёт дисциплину коммуникации (намерение, дельта, KB). Не фиксирует:

• в какой момент оператору нужны alternatives vs blast radius vs tests;
• где в UI это живёт при primary_work_surface = intercom 0120;
• как SM, CRS, HCI, intent card складываются в один поток, а не конкурируют.

Симптом: SM / Correspondence как демка

Гипотеза: UX выстраивать от SEDM-фазы и information need, а SM/CRS/HCI — источники данных для Process/Perceive, не самоцель.

SEDM vs SDM (имя)

Решение

1. Фазы SEDM (непрерывный цикл)

PERCEIVE   → обстановка: workline, файл, что применимо (PAVE)
PROCESS    → анализ: alternatives, risk, consistency (CARE)
PERFORM    → действие: steer, код, verify (TEAM)
EVALUATE   → satisficing → снова PERCEIVE

Правило UX: на активной Surface доминирует одна фаза; соседняя — одна строка hint, не полный dump.

2. Information needs по фазам (сжатая матрица)

Источник: Tao 2012, Pascarella 2018, Al Safwan 2019 — полная таблица в KB research.

3. Лестница артефактов (T0–T4)

Intent card — сессионное решение (почему B отвергли). Context card — «зачем этот файл сейчас» (не ADR, не intent card).

3.1 Context card v1 (schema, целевая)

Проекция в scope strip 0172 и/или collapsed system block; источники: active workline, attach anchor, [workspace.adr.map] 0061, feature registry 0155.

{
  "schema_version": 1,
  "anchor": { "path": "Features/…/Foo.cs", "symbol": "optional" },
  "workline": { "id": "wl-…", "label": "habitat G2", "intent_tag": "cascade-ide/habitat" },
  "applies": [
    { "kind": "adr", "ref": "0172", "one_liner": "Session graph habitat", "provenance": "path_map" }
  ],
  "path_hint": "0172 habitat → 0120 intercom → этот файл",
  "risk_advisory": "optional I-9 hint",
  "drill_down": ["crs", "sm_subgraph", "hci_search"]
}

UI (operator, не протокол):

Here: Foo.cs · workline «habitat G2»
Applies: ADR 0172 — session graph; ADR 0120 — intercom surface
Path: habitat → intercom → Features/…/Foo.cs
        [detail] [SM] [record intent]

Слои L0–L4 остаются в модели correspondence; в T2 — human sentences + provenance на строку (аналог EXTRACTED/INFERRED в SEDM vocabulary).

4. Поверхности × фазы × VDS

Conversation-first: moat на scope strip + context card + intent card 0172 G2–G4, не на hero polish PFD graph.

5. Перепривязка SM и Correspondence

Идеи внешних KG-инструментов (path, explain, provenance tags) — в vocabulary SEDM, без обязательной зависимости от сторонних пакетов.

6. Harness и агент (направление)

0166: materialization сжатого context card + последней intent card активной workline в system one-liner.

Опционально (фаза S3+): sedm_phase: perceive | process | perform в meta сессии — bias промпта («сейчас не dump тестов, собери alternatives»).

Query-first (до массового Read): codebase_index_search, get_code_navigation_context — Perceive/Process до file crawl.

Отклонённые альтернативы

Последствия

• UX backlog и VDS DoD привязываются к фазам SEDM, не к списку приборов.
• SM/CRS/HCI получают роль data sources с явной фазой.
• Новая работа: context card (T2) — schema, scope strip, drill-down в CRS/SM.
• Intent card 0173 — T1 в той же лестнице.
• 0061 — приоритизировать one-liner Applies, не полный GPWS v2.

Фазы внедрения

Приоритет moat: S1–S2 выше S4–S5 (граф polish).

Открытые вопросы

• Связь с EICAS/Health: advisory только в Evaluate/Perform, не в Perceive prose 0021.
• Debounce context_card_materialized и политика auto-stale decisions — при реализации S1/S2.

Закрыто (unified model v1.1+, 2026-07-12): SEDM internal; T2 = событие в 0045; sedm_phase → протокол маркеров [WORK/HUMAN]-style (KB §11); SM off by default для operator.

Punchline

IOP — дисциплина намерения. SEDM — цикл инженерного решения. UX — Surface для Perceive/Perform; SM/CRS — Process под капотом. Без SEDM приборы без пилота.