architect(ET): auto-commit from architect run_id=778

docs/architecture/README.md

@@ -650,6 +650,32 @@ ORCH-027 вводит детерминированный (без LLM) **гейт
 `docs/work-items/ORCH-088/08-data-requirements.md`,
 `docs/work-items/ORCH-124/06-adr/ADR-001-serial-gate-pause-without-blocking.md`.
 
+### Открытые вопросы аналитика → Needs Input (ORCH-120 — design, [adr-0053](adr/adr-0053-analyst-open-questions-needs-input-flow.md))
+При неоднозначном бизнес-запросе у аналитика не было рабочего канала уточнения — он **фабриковал**
+требования, чтобы сдать обязательные 4 файла. Механизм «вопросы → Needs Input» в
+`_handle_analysis_approved_flow` (`src/stage_engine.py`) существовал, но был **мёртв** (контракт не в
+промпте; ветка `files_ok` имела приоритет; Needs Input клинил serial-gate; нет гигиены устаревшего
+`01-questions.md`). ORCH-120 **активирует и достраивает** путь — аддитивно, под kill-switch, скоуп
+self-hosting, never-raise; `STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД —
+**байт-в-байт не тронуты** (поток — pre-gate-ветка движка, **не** QG; `01-questions.md` — сигнальный
+артефакт, **не** machine-verdict).
+- **Контракт + канон.** `.openclaw/agents/analyst.md` документирует «блокирующие вопросы →
+  `01-questions.md`, НЕ фабриковать deliverables»; `01-questions.md` стандартизирован как
+  `when-applicable` сигнальный артефакт (скелет `docs/_templates/` + строка `PIPELINE_DOCS.md`).
+- **Приоритет «вопросы активны» > «файлы готовы»** в `_handle_analysis_approved_flow` (DQ-3) →
+  блокирующие вопросы достигают Needs Input даже при частичных/сфабрикованных deliverables.
+- **Авто-park (DQ-1)** через ось «пауза» ORCH-124 (`db.set_task_paused` при Needs Input) → задача
+  исключается из «активного» предиката serial-gate, FIFO репо не клинит, пока ждём человека;
+  **resume + unpark** в `handle_status_start` (analysis-ветка, `clear_task_paused`).
+- **Устаревание (DQ-2)** — детерминированный offline freshness-supersede по mtime (вопросы активны,
+  пока пакет неполон ИЛИ `01-questions.md` не старше всех 4 deliverables) → полный свежий пакет
+  supersede’ит старый файл без зависимости от LLM.
+- **Флаги** (`config.py`): `analyst_questions_gate_enabled` (kill-switch) / `analyst_questions_gate_repos`
+  (CSV; **пусто → self-hosting only**) / `analyst_needs_input_autopause_enabled` (независимый тумблер
+  авто-park/unpark; `False` → operator-park `POST /serial-gate/pause`). off/out-of-scope → байт-в-байт
+  как до ORCH-120 (enduro не затронут). ORCH-066 (Needs Input только у аналитика) не расширяется.
+  Детали — `docs/work-items/ORCH-120/06-adr/ADR-001-analyst-open-questions-needs-input.md`.
+
 ### Авто-режим по лейблам: autoApprove + autoDeploy (ORCH-089 — реализовано)
 Конвейер имеет два **человеческих** гейта, тормозящих пакетный автономный прогон (эпик
 ORCH-088): гейт BRD (`analysis`: ждёт ручного `Approved`) и гейт прод-деплоя (`deploy`: