ORCH-118: LLM call-site map, control-path axis, roadmap & usage policy (docs+tests only) #140
Reference in New Issue
Block a user
Delete Branch "feature/ORCH-118-orch-replace-avoidable-llm-con"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
ORCH-118 — replace avoidable LLM control paths (inventory-first, docs+tests only)
Zonтичный follow-up RCA-трека ORCH-114/117. Выпускает доказательную карту мест вызова LLM, control-path-ось «avoidable», roadmap детерминированных замен и нормативную политику — прибитые к коду структурными анти-дрейф тестами. Раннеры замен не реализуются (FR-7).
Что в PR
docs/architecture/llm-call-sites.md— карта + машинно-читаемый блок инвентаря (id|role|location|output_consumer|consults_llm|axis|avoidable|classification) + control-path-разметка + классификация + keep-LLM-обоснования + раздел детерминизма не-агентских путей (FR-1/2/3/8).docs/architecture/llm-determinization-roadmap.md— упорядоченные кандидаты по роли, оценка экономии изagent_runs, первый срез = deployer (staging-status) (FR-4). Без выдуманных Plane-ID (R3/NFR-6).docs/architecture/llm-usage-policy.md— нормативный принцип, критерии keep/replace через ось, определение «avoidable LLM control path» как двухбитного предиката (FR-5/8).tests/test_llm_call_site_inventory.py— TC-01/02/03/04/05/06/09/12/13/14.tests/test_llm_determinization_docs.py— TC-07/08/11.CHANGELOG.md+docs/overview/tech-quality-security.md— golden-source sync (AC-8). (Секция README + adr-0047 заведены на стадии architecture.)Ключевой результат
{tester, deployer}; control-path-но-keep ={reviewer}; не-control-path (P) ={analyst, architect, developer}; эталон ={deploy-finalizer, post-deploy-monitor}.launcher._spawn(S0); иного транспорта нет (TC-12).Инварианты / скоуп
src/**не тронут →STAGE_TRANSITIONS/ реестр и именаQG_CHECKS/check_*/ machine-verdict-ключи / схема БД — байт-в-байт (TC-09). kill-switch не нужен (нет рантайм-поведения).main.Проверки
ruff checkновых файлов — чисто.pytest tests/ -q— 2081 passed (13 новых тестов зелёные).Refs: ORCH-118
🤖 Generated with Claude Code
ORCH-118 (inventory-first, docs+tests only): publish an evidence-based map of every place the orchestrator's control flow consumes (or can consume) an LLM judgment, mark the control-path axis (C control-path vs P artifact-producer), define "avoidable LLM control path" as a checkable two-bit predicate, classify each call-site, and order the deterministic-replacement roadmap. Pin the map to code with offline structural anti-drift tests. - docs/architecture/llm-call-sites.md — map + machine-readable inventory block + control-path axis + classification + keep-LLM justifications + deterministic non-agent paths (FR-1/FR-2/FR-3/FR-8). - docs/architecture/llm-determinization-roadmap.md — ordered candidates BY ROLE, savings sourced from agent_runs, recommended first slice = deployer staging (FR-4). No fabricated follow-up Plane-IDs (R3/NFR-6). - docs/architecture/llm-usage-policy.md — normative principle, keep/replace criteria via the axis, definition of "avoidable LLM control path" (FR-5/FR-8). - tests/test_llm_call_site_inventory.py — TC-01/02/03/04/05/06/09/12/13/14. - tests/test_llm_determinization_docs.py — TC-07/08/11. - CHANGELOG.md + docs/overview/tech-quality-security.md — golden-source sync (AC-8). Avoidable LLM control paths = {tester, deployer}; control-path-keep = {reviewer}; not-control-path (P) = {analyst, architect, developer}. Single LLM transport = launcher._spawn (S0); no alternative transport (TC-12). Runtime untouched: STAGE_TRANSITIONS / QG_CHECKS / check_* / machine-verdict keys / DB schema are byte-for-byte; no replacement runners implemented (FR-7). Full suite: 2081 passed. Refs: ORCH-118 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>