its-magic 0.1.2-55 → 0.1.2

package/template/docs/engineering/auto-orchestration-reference.md

@@ -743,10 +743,13 @@ requires it.
 
 ### Outer-driver equivalence (AC-1, Option B)
 
-When a single Cursor `/auto` invocation cannot schedule multiple fresh subagent
-turns (product/runtime constraint), a **documented outer driver** (operator
-script or manual re-invocation with `start-from` / refreshed `resume_brief`) is
-**deterministically equivalent** provided all of the following hold:
+**native chain supersedes Option B** under **`AUTO_FLOW_MODE=full_autonomy`** + IDE + Task
+available — native in-chat chain is **primary**. When a single Cursor `/auto` invocation
+cannot schedule multiple fresh subagent turns (product/runtime constraint), a **documented
+outer driver** (operator script or manual re-invocation with `start-from` / refreshed
+`resume_brief`) is **deterministically equivalent** (**fallback only** — applies when
+**`NATIVE_CHAIN_UNAVAILABLE`** or headless/CI/`--invoke-cmd` context) provided all of the
+following hold:
 
 - Same intersected phase order as a single-invocation run.
 - Same per-phase isolation evidence (**DEC-0029**) + strict-proof attestation
@@ -766,7 +769,7 @@ script or manual re-invocation with `start-from` / refreshed `resume_brief`) is
 | `AUTO_PAUSE_REQUEST` / `pause` | **Stop** at safe boundary | **Always** (non-suppressible) |
 | `AUTO_LOOP_MAX_CYCLES` / `loop_max` | **Stop** | **Always** (non-suppressible) |
 | `blocked` (sync/scope gate) | **Stop** | **Always** (non-suppressible) |
-| US lifecycle DONE / sprint segment complete | **Stop** segment; `AUTO_BACKLOG_DRAIN=1` may advance to next OPEN story (recompute phase plan — **Step 5**) | Notify on segment handoff (non-routine) |
+| US lifecycle DONE / sprint segment complete | **IDE `full_autonomy`**: orchestrator **must** drain-advance in-chat (no operator re-`/auto`). **Other modes / fallback**: stop segment; `AUTO_BACKLOG_DRAIN=1` may advance (recompute phase plan — **Step 5**) | Notify on segment handoff (non-routine) |
 | `BACKLOG_MAX_STORIES_REACHED` | **Stop** | **Always** (non-suppressible) |
 
 `stop_reason` vocabulary: `completed`, `decision_gate`, `missing_input`,
@@ -780,7 +783,7 @@ script or manual re-invocation with `start-from` / refreshed `resume_brief`) is
 
 | Condition | US-0088 | `full_autonomy` delta | Operator notify |
 |-----------|---------|------------------------|-----------------|
-| Next phase, no hard stop | Continue inner `/auto` | Outer driver **re-invokes** when Cursor ends turn early | Quiet OK when `AUTO_QUIET=1` |
+| Next phase, no hard stop | Continue inner `/auto` | Native chain continues in-chat; outer driver **re-invokes** only on **`NATIVE_CHAIN_UNAVAILABLE`** / headless **fallback** | Quiet OK when `AUTO_QUIET=1` |
 | `decision_gate` | Hard stop | **No change — hard** | Always |
 | Unrecoverable `error` | Hard stop | **No change — hard** | Always |
 | Critical `missing_input` | Hard stop | **No change — hard** | Always |
@@ -790,7 +793,7 @@ script or manual re-invocation with `start-from` / refreshed `resume_brief`) is
 | `blocked` — transient/sync | Hard stop | **Relaxable** when recoverable | Notify on cap |
 | `blocked` — isolation/strict-proof/ownership | Hard stop | **No change — hard** | Always |
 | UAT/QA fail | Hard stop (operator) | **Relaxable** when `AUTO_IMPLEMENTATION_LOOP=1` | Notify on cap |
-| Segment complete + `AUTO_BACKLOG_DRAIN=1` | Advance (may need manual re-`/auto`) | **Drain-advance-without-pause** — immediate next item | Segment handoff notify |
+| Segment complete + `AUTO_BACKLOG_DRAIN=1` | Advance (may need manual re-`/auto` in non-native modes) | **Drain-advance-without-pause** — immediate in-chat continuation; **no** operator re-`/auto` | Segment handoff notify |
 | `BACKLOG_MAX_STORIES_REACHED` | Hard stop | **No change — hard** | Always |
 | `AUTO_SCHEDULER_CONFLICT` | Hard stop | **No change — hard** | Always |
 | `RELEASE_PUBLISH_MODE=auto` | Explicit opt-in | **No change — hard default-off** | Always on publish |
@@ -810,7 +813,8 @@ verify → caps → branch. **`NATIVE_CHAIN_UNAVAILABLE`** when Task tool denied
 depth limit hit — hard stop for native path; suggest outer driver as **optional** fallback.
 
 **Activation gate**: `full_autonomy` + IDE context + Task tool → set **`native_chain_active=true`**
-in `state.md` boundary.
+in `state.md` boundary. Set **`native_chain_continuing=true`** when orchestrator scheduled
+next spawn/advance **this** boundary.
 
 **Spawn-only invariants** (**BUG-0006**): orchestrator schedules phase-role subagents only;
 each phase completes via fresh spawn + artifacts; no in-band phase work.
@@ -833,8 +837,16 @@ enabled (**`AUTO_BACKLOG_DRAIN=1`** or bug-queue per **US-0087** mutex); budget
 | **6** | **APPEND** `state.md` materialization breadcrumb for new segment |
 | **7** | **IMMEDIATELY** spawn first phase subagent — **without operator re-`/auto`**, **no** mandatory outer-driver instruction |
 
+**Between steps 6 and 7** (no operator stop): orchestrator **must not** emit operator wait
+instructions, set **`stop_reason=completed (segment exhausted)`** when drain budget > 0 and
+eligible OPEN item exists, or skip Task-spawn for step **7**. Attest
+**`drain_advance_action=spawned|skipped|not_applicable`** on `state.md` phase boundary;
+**`skipped`** when budget > 0 + OPEN item exists is **invalid** (regression).
+
 **DEC-0069 pairing mandate**: every phase boundary and drain advance **must** refresh
-**`resume_brief`** + **`state.md`** before scheduling in-chat continuation.
+**`resume_brief`** + **`state.md`** before scheduling in-chat continuation. Orchestrator
+**MUST Task-spawn** next phase — **`/auto`** is orchestrator context label, not operator
+re-invocation instruction.
 
 ### Native-chain stop matrix (US-0095)
 
@@ -882,7 +894,9 @@ no secrets. IDE native chain and outer driver **share one accounting model**:
 
 | Field | Semantics |
 |-------|-----------|
-| **`native_chain_active`** | `true` when IDE native chain is driving continuation |
+| **`native_chain_active`** | `true` when IDE native chain is driving continuation (gate eligibility) |
+| **`native_chain_continuing`** | `true` when orchestrator scheduled next spawn/advance **this** boundary |
+| **`drain_advance_action`** | `spawned` \| `skipped` \| `not_applicable` — step 7 outcome at segment boundary |
 | **`outer_cycle_index`** | Continuation cycles this run (int ≥ 0) |
 | **`implementation_loop_index`** | Inner remediation cycles for current story segment (int ≥ 0) |
 
@@ -945,9 +959,101 @@ conditions the script is a no-op and the fail-closed reason codes from
 `test_caveman_compress_input_*` subtests in
 `tests/auto_command_contract_test.py` (**DEC-0073** §11).
 
+### `DELIVERY_MODE` × `TOKEN_PROFILE` × `CAVEMAN_MODE` non-substitution (US-0096 / DEC-0082 §1)
+
+> **`DELIVERY_MODE`** controls lifecycle shape and artifact surfaces only. **`TOKEN_PROFILE`** controls context breadth / token cost only (**DEC-0062**). **`CAVEMAN_MODE`** controls reply voice only (**DEC-0072**). None substitutes for another.
+
+Scratchpad keys: **`DELIVERY_MODE`** (`standard` | `ultra_lean` | `mega_quick`, default **`standard`**);
+**`LEAN_MEMORY_READ`**, **`LEAN_MEMORY_WRITE`**, **`LEAN_COLD_READ_MAX_SECTIONS`** (default **4**),
+**`LEAN_STATE_INDEX_ROWS`** (default **80**), **`AUTO_DELIVERY_ROUTING`**
+(`scratchpad_only` | `backlog_then_scratchpad`, default **`scratchpad_only`**).
+
+### Mode-scoped delivery resolver — step 0 (US-0096 / DEC-0082)
+
+**Before** **DEC-0052** pipeline, **resolve_delivery_mode**: argv `delivery-mode=` → backlog row
+`delivery_mode` (when **`AUTO_DELIVERY_ROUTING=backlog_then_scratchpad`**) → scratchpad
+**`DELIVERY_MODE`** → **`standard`**.
+
+| `delivery_mode` | `resolved_phase_plan` | `reinstatement_mode` | `memory_layer` |
+|-----------------|----------------------|---------------------|----------------|
+| `standard` | Full **DEC-0052** chain | `dec0052_default` | `standard` |
+| `ultra_lean` | `[spec, plan, build+verify, ship]` | `none` | `pack` |
+| `mega_quick` | `[quick]` when eligible | `none` | `quick` |
+
+**reinstatement applies only when delivery_mode=standard**. **`AUTO_PHASE_*`** applies **only**
+when `delivery_mode=standard`; non-standard + non-default **`AUTO_PHASE_*`** →
+**`PHASE_POLICY_CONFLICT`**. **`DELIVERY_MODE_SWITCH_MID_STORY`**: fail closed.
+
+Breadcrumbs: **`delivery_mode`**, **`resolved_phase_plan`**, **`reinstatement_mode`**, **`memory_layer`**.
+
+#### `ultra_lean` macro-phases
+
+| Macro | Merged phases | Role |
+|-------|---------------|------|
+| **`spec`** | intake + discovery | **po** |
+| **`plan`** | research + architecture + sprint-plan | **tech-lead** |
+| **`build+verify`** | execute + qa + verify-work | **dev** / **qa** |
+| **`ship`** | release + refresh-context | **release** / **curator** |
+
+**`AUTO_IMPLEMENTATION_LOOP`** preserved inside **`build+verify`**. No eleven-phase reinstatement.
+
+#### `mega_quick` eligibility
+
+Fail-closed codes: **`MEGA_QUICK_BUG_SEGMENT`**, **`MEGA_QUICK_AC_TOO_BROAD`**,
+**`MEGA_QUICK_ARCHITECTURE_REQUIRED`**, **`MEGA_QUICK_SPRINT_EXISTS`**,
+**`MEGA_QUICK_STORY_OVERRIDE`**, **`MEGA_QUICK_MULTI_COMPONENT`**, **`MEGA_QUICK_GATE_ESCALATION`**.
+Ineligible → **`DELIVERY_MODE_INELIGIBLE`** + specific code.
+
+### Layered memory tiers (US-0096 / DEC-0082 §5)
+
+| Tier | Path | Triad? | Cap |
+|------|------|--------|-----|
+| Hot | **`handoffs/active-context.md`** | **No** | **`LEAN_STATE_INDEX_ROWS`** (default **80**) |
+| Warm | **`work/<story_id>/pack.json`** | n/a | **16 KiB** soft |
+| Cold | vision / architecture / decisions sections | n/a | **`LEAN_COLD_READ_MAX_SECTIONS`** (default **4**) |
+
+**`active-context.md` is NOT a triad member** — **`enforce-triad-hot-surface.py`** does not scan it.
+Oversize with **`LEAN_MEMORY_WRITE=1`** → **`ACTIVE_CONTEXT_OVERSIZE`**.
+
+**`pack.json` schema v1** — validator **`scripts/pack_json_validate.py`**; reason codes **`PACK_*`**.
+Required: **`schema_version`** (`"1"`), **`story_id`**, **`delivery_mode`**, **`status`**, **`ac[]`**,
+**`tasks[]`**, **`refs[]`**, **`deltas[]`**, **`memory_layer`** (`"pack"`).
+
+| Mode | Authoritative tasks surface |
+|------|----------------------------|
+| `standard` | **`sprints/Sxxxx/tasks.md`** |
+| `ultra_lean` | **`work/US-xxxx/pack.json`** `tasks[]` |
+| `mega_quick` | **`sprints/quick/Qxxxx/task.json`** |
+
+### Quality floor + lean memory gates (US-0096 / DEC-0082 §8–§9)
+
+All lean modes: tests before stop; AC traceability in pack/task.json; new patterns →
+architecture/decision delta; **`active-context.md`** updated on material learnings; no secrets/publish
+bypass. **`LEAN_MEMORY_READ=0`** or **`LEAN_MEMORY_WRITE=0`** on **`ultra_lean`** spawn →
+**`LEAN_MEMORY_DISABLED`** (fail closed).
+
+### Run-class extension (US-0096 / DEC-0082 §9 — amends DEC-0062)
+
+Sorted JSON run-class object **must** include **`delivery_mode`**. Evidence rows in
+**`handoffs/token_cost_runs/<orchestrator_run_id>.md`** **must** include **`delivery_mode`** column.
+**`ultra_lean`** vs **`standard`** same story → **`TOKEN_COST_RUN_CLASS_MISMATCH`**.
+
+### Dev environment auto-launch profile (US-0098 / DEC-0084)
+
+**`DEV_AUTO_LAUNCH_PROFILE`** (`off` | `deterministic_v1`, default **`off`**) gates execute step **24**
+— zero overhead when **`off`**. Orthogonal to **`AUTO_REMOTE_AUTOMATION_PROFILE`** (**US-0086**):
+when both **`deterministic_v1`**, **US-0086** remote target resolution (**`docker`** / **`ssh`**) wins
+over **`docker-host-local`**. Persisted profile at **`.cursor/dev-environment.json`** (names-only
+**`*Env`** refs in **`connect`**); **no** **`release-targets.json`** schema change (**US-0064**
+unchanged). **US-0085** inheritance: helper and step **24** never read **`.env`**. **`DEV_SERVER_*`**
+scratchpad keys compose with **`local`** detection. Fail closed → **`DEV_ENV_DETECT_AMBIGUOUS`**
+when stack cannot be resolved. Connect block fields align with
+**`docs/engineering/runtime-connectivity.md`** operator summary template.
+
 ## Steps
-1. Read automation flags from merged scratchpad and **materialize the resolved
-   phase plan** per **Configurable phase selection policy (US-0070 / DEC-0052)**:
+1. **resolve_delivery_mode** (step 0 — **US-0096 / DEC-0082**) then read automation flags from
+   merged scratchpad and **materialize the resolved phase plan** per mode + **Configurable phase
+   selection policy (US-0070 / DEC-0052)** when `delivery_mode=standard`:
    detect exactly-one policy mode, expand, apply non-skippable reinstatement,
    validate tokens/profile/ack requirements, and append plan breadcrumbs
    (`phase_policy_mode`, `resolved_phase_plan`, `skipped_phases` + reasons) to
@@ -986,8 +1092,9 @@ conditions the script is a no-op and the fail-closed reason codes from
    **deterministic stop condition** fires (see **Deterministic stop matrix
    (US-0088)** above). The orchestrator does **not** stop after a single phase
    spawn unless the stop matrix requires it; outer-driver equivalence applies
-   when native chain is unavailable or a single invocation cannot schedule
-   multiple subagent turns (see **Outer-driver equivalence (AC-1, Option B)** above):
+   when **`NATIVE_CHAIN_UNAVAILABLE`**, headless/CI, or `--invoke-cmd` prevents in-chat
+   scheduling (see **Outer-driver equivalence (AC-1, Option B)** above — **fallback only**;
+   **native chain supersedes Option B** in IDE **`full_autonomy`**):
    default full path:
    intake -> discovery -> research -> architecture -> sprint plan ->
    plan verify -> execute -> QA -> verify work -> release -> refresh context.

package/template/docs/engineering/context/installer-owned-paths.manifest

@@ -38,8 +38,9 @@ scripts/check_downstream_ci_guard.py
 scripts/downstream_ci_guard_lib.py
 scripts/auto_outer_driver.py
 scripts/uat_probe_lib.py
+scripts/project_readme_coverage_lib.py
+scripts/validate_project_readme_coverage.py
 .github/workflows
-README.md
 its_magic
 
 [clean_paths]
@@ -71,6 +72,8 @@ scripts/check_downstream_ci_guard.py
 scripts/downstream_ci_guard_lib.py
 scripts/auto_outer_driver.py
 scripts/uat_probe_lib.py
+scripts/project_readme_coverage_lib.py
+scripts/validate_project_readme_coverage.py
 .github/workflows/ci.yml
 .github/workflows/deploy.yml
 its_magic

package/template/docs/engineering/runbook.md

@@ -128,16 +128,17 @@ Normative H2 titles and matrix: `docs/engineering/architecture.md` (`# US-0077`)
 ## README feature coverage validation (US-0091 / DEC-0074)
 
 **Goal:** ensure every DONE user-visible backlog item (`US-xxxx` / `BUG-xxxx` with
-`user_visible: true`) has operator blurbs in root `README.md` and traceability rows in
-`docs/developer/README.md`, without inventing new `USER_*` / `DEV_*` H2 literals
-(**DEC-0059** composes; **US-0030** delta gate unchanged).
+`user_visible: true`) has operator blurbs in **`its_magic/README.md`** (framework catalog)
+and traceability rows in `docs/developer/README.md`, without inventing new `USER_*` / `DEV_*`
+H2 literals (**DEC-0059** composes; **US-0030** delta gate unchanged). Consumer root
+`README.md` is **out of scope** for this gate — see **US-0097** / **DEC-0083**.
 
 ### Delta vs static doc gates
 
 | Gate | Question | Remediation |
 |------|----------|-------------|
 | **US-0030** (delta) | Did this sprint change commands/flags without README/runbook updates? | Update command docs for changed surfaces; agent checklist in `/release` step 3 family. |
-| **US-0091** (static) | Is every DONE user-visible item documented in the README family? | Backfill root + DEV shard; set `user_visible:` marker; run validator `--report`. |
+| **US-0091** (static) | Is every DONE user-visible item documented in the framework README family? | Backfill **`its_magic/README.md`** + DEV shard; set `user_visible:` marker; run validator `--report`. |
 
 ### Scratchpad key
 
@@ -167,6 +168,120 @@ Reason codes: `README_FEATURE_COVERAGE_BLOCKED`, `README_FEATURE_COVERAGE_GAP:<i
 Normative predicate + affinity manifest: `decisions/DEC-0074.md`,
 `docs/engineering/context/readme-section-affinity.json`.
 
+## Project README coverage validation (US-0097 / DEC-0083)
+
+**Goal:** ensure project-owned root `README.md` has a bootstrap scaffold and growing
+feature catalog under `<!-- project-readme-feature-catalog -->` for every DONE
+`user_visible: true` backlog item. Framework catalog remains in **`its_magic/README.md`**
+(**US-0091** gate **3f** — independent from project gate **3g**).
+
+### Placeholder sentinels S1–S5
+
+| Signal | Detection rule | Verdict |
+|--------|----------------|---------|
+| **S1** | H1 `# its-magic — AI dev team` | placeholder |
+| **S2** | `<!-- readme-feature-coverage-catalog -->` | placeholder |
+| **S3** | Heading `Feature coverage catalog (US-0091)` | placeholder |
+| **S4** | Byte-identical to `template/README.md` | placeholder |
+| **S5** | None of S1–S4 + custom title/purpose | **operator-authored** — preserve |
+
+**Detection order**: `FRAMEWORK_KIT_REPO=1` → S1–S4 → S5. Hybrid roots fail closed with
+`PROJECT_README_MIGRATION_AMBIGUOUS` or `PROJECT_README_SENTINEL_CONFLICT`.
+
+### Migration algorithm M1–M5
+
+| Step | Condition | Action |
+|------|-----------|--------|
+| **M1** | `FRAMEWORK_KIT_REPO=1` | Skip consumer migration |
+| **M2** | Root **S5** | Preserve root; copy to **`its_magic/README.md`** if missing |
+| **M3** | Root **S1–S4**, **`its_magic/`** missing | Lift root → **`its_magic/README.md`** |
+| **M4** | Root **S1–S4** after **M3** | Replace root with project scaffold |
+| **M5** | Hybrid / ambiguous | Fail closed |
+
+### Scratchpad keys
+
+- `PROJECT_README_ENFORCE`: `0` \| `1` (default `1` post-bootstrap).
+- `FRAMEWORK_KIT_REPO`: `0` \| `1` (default `0`; consumer repos never `1`).
+
+**Grandfathering:** set `PROJECT_README_ENFORCE=0` during migration; flip to `1` when
+`validate_project_readme_coverage.py --report` shows `coverage_missing: []`.
+
+### Commands
+
+```bash
+python scripts/validate_project_readme_coverage.py --self-test
+python scripts/validate_project_readme_coverage.py --repo . --report
+python scripts/validate_project_readme_coverage.py --repo . --audit-out docs/engineering/context/project-readme-coverage-audit.json
+python scripts/validate_project_readme_coverage.py --repo . --enforce
+python scripts/check_intake_template_parity.py --scope=project-readme
+```
+
+Reason codes: `PROJECT_README_COVERAGE_BLOCKED`, `PROJECT_README_COVERAGE_GAP:<id>`,
+`PROJECT_README_DELTA_SKIPPED`, `PROJECT_README_BOOTSTRAP_SKIPPED`,
+`PROJECT_README_MIGRATION_AMBIGUOUS`, `PROJECT_README_SENTINEL_CONFLICT`,
+`PROJECT_README_PLACEHOLDER_UNRESOLVED`, `PROJECT_README_ENFORCE_SKIPPED`,
+`PROJECT_README_INPUT_INVALID`.
+
+### Operator recipes (US-0097)
+
+| Scenario | Operator action |
+|----------|-----------------|
+| Fresh consumer repo | First **`/execute`** bootstraps project README; framework catalog in **`its_magic/`** |
+| Legacy framework root README | Run **`upgrade`** — migration **M3**/**M4** lifts to **`its_magic/`** + project scaffold |
+| Operator-authored root (S5) | Migration preserves root; adds **`its_magic/README.md`** if missing |
+| Hybrid / ambiguous root | Fix manually per **`PROJECT_README_MIGRATION_AMBIGUOUS`** — remove mixed sentinel + custom prose |
+| Migration window | Set **`PROJECT_README_ENFORCE=0`**; backfill catalog bullets; flip to **`1`** when **`--report`** clean |
+| Kit repo dogfooding | Set **`FRAMEWORK_KIT_REPO=1`** — skip consumer bootstrap (**23a**/**23b**) and project validator root check |
+
+**Troubleshooting:** `PROJECT_README_COVERAGE_BLOCKED` at release **3g** → run `--report`,
+backfill missing `US-xxxx` bullets under `<!-- project-readme-feature-catalog -->`.
+`PROJECT_README_MIGRATION_AMBIGUOUS` → split framework content to **`its_magic/README.md`**
+manually, then re-run migration. Implementation tranche order: A (installer + migration) →
+B (bootstrap) → C (execute **23** + release **3g** + scratchpad) → D (validators + tests).
+
+Normative contract: `decisions/DEC-0083.md`, `docs/engineering/architecture.md` `# US-0097`.
+
+## Dev environment auto-launch (US-0098 / DEC-0084)
+
+**Goal:** execute-phase bounded rebuild/restart of dev stacks plus **Connect** surfacing after
+implementation changes — distinct from **US-0065** phase QA, **US-0086** test routing, and
+**US-0067** release hints. Default-off scratchpad gate; **no** `.env` reads (**US-0085**).
+
+### Operator recipes
+
+| Scenario | Operator action |
+|----------|-----------------|
+| Enable dev auto-launch | Set **`DEV_AUTO_LAUNCH_PROFILE=deterministic_v1`** in scratchpad |
+| Seed profile | Copy **`template/.cursor/dev-environment.json.example`** → **`.cursor/dev-environment.json`**; set compose **`service`** + **`*Env`** connect refs |
+| Force relaunch | Send exact phrase **`refresh dev environment`** (case-sensitive whole phrase) |
+| Profile off / manual mode | Leave **`DEV_AUTO_LAUNCH_PROFILE=off`** (default) — execute step **24** zero overhead |
+| Ambiguous stack | Fix compose path or seed profile; remediate **`DEV_ENV_DETECT_AMBIGUOUS`** |
+| Remote + local both on | **US-0086** remote wins over **docker-host-local** — see precedence in **`DEC-0084`** §3 |
+| Bind-mount hot reload | Default skip on source-only docker changes; use refresh or **`restart_on_source_change=true`** |
+
+### Troubleshooting (`DEV_ENV_*` reason codes)
+
+**Profile family:** **`DEV_ENV_PROFILE_DISABLED`**, **`DEV_ENV_PROFILE_INVALID`**,
+**`DEV_ENV_PROFILE_MISSING`**, **`DEV_ENV_DETECT_AMBIGUOUS`**, **`DEV_ENV_COMPOSE_UNRESOLVED`**,
+**`DEV_ENV_TARGET_DISABLED`**, **`DEV_ENV_SECRET_SURFACE_VIOLATION`**.
+
+**Relaunch family:** **`DEV_ENV_RELAUNCH_SKIPPED_NO_SURFACE`**, **`DEV_ENV_RELAUNCH_SKIPPED_PROFILE_OFF`**,
+**`DEV_ENV_RELAUNCH_FAILED`**, **`DEV_ENV_RELAUNCH_RETRY_EXHAUSTED`**, **`DEV_ENV_RELAUNCH_TIMEOUT`**,
+**`DEV_ENV_CONNECT_UNAVAILABLE`**.
+
+### Commands
+
+```bash
+python scripts/dev_environment_lib.py --self-test
+python scripts/dev_environment_lib.py --load .cursor/dev-environment.json
+python scripts/check_intake_template_parity.py --scope=dev-environment
+pytest -k us0098 tests/auto_command_contract_test.py
+```
+
+Implementation tranche order: **A** (schema + scratchpad) → **B** (stdlib helper) → **C** (execute step **24** + docs) → **D** (contract tests + parity + harness).
+
+Normative contract: `decisions/DEC-0084.md`, `docs/engineering/architecture.md` `# US-0098`.
+
 ## User-visible internal metadata guard (US-0071 / DEC-0053)
 
 **Goal:** keep planning-shaped identifiers out of **operator-visible software
@@ -447,9 +562,76 @@ Manual override precedence:
   **`.jsonl`**); copy path into **`token_cost_evidence_ref`** on **`state.md`** checkpoints.
 - **AC-2**: compare **`cache_read_tokens`** only when **`run_class_hash`** matches; else
   **`TOKEN_COST_RUN_CLASS_MISMATCH`**.
+- **`delivery_mode`** (US-0096 / DEC-0082): required key in sorted JSON run-class object
+  (amends **DEC-0062**). Evidence rows in **`handoffs/token_cost_runs/<orchestrator_run_id>.md`**
+  **must** include **`delivery_mode`** column. **`ultra_lean`** vs **`standard`** on same story →
+  **`TOKEN_COST_RUN_CLASS_MISMATCH`**. Tranche A target: **≥10%** **`cache_read_tokens`** reduction
+  on matched **`standard`** runs vs pre-US-0096 baseline.
 - **CI/repo checks**: `python scripts/check_token_cost_parity.py --repo .` (manifest-listed
   active/`template/` pairs); **`tests/run-tests.ps1`** / **`tests/run-tests.sh`** §26M.
 
+### Delivery modes (US-0096 / DEC-0082)
+
+> **`DELIVERY_MODE`** controls lifecycle shape and artifact surfaces only. **`TOKEN_PROFILE`** controls context breadth / token cost only (**DEC-0062**). **`CAVEMAN_MODE`** controls reply voice only (**DEC-0072**). None substitutes for another.
+
+| Key | Values | Default |
+|-----|--------|---------|
+| **`DELIVERY_MODE`** | `standard` \| `ultra_lean` \| `mega_quick` | `standard` |
+| **`LEAN_MEMORY_READ`** | `0` \| `1` | `1` |
+| **`LEAN_MEMORY_WRITE`** | `0` \| `1` | `1` |
+| **`LEAN_COLD_READ_MAX_SECTIONS`** | int ≥ 1 | `4` |
+| **`LEAN_STATE_INDEX_ROWS`** | int ≥ 30 | `80` |
+| **`AUTO_DELIVERY_ROUTING`** | `scratchpad_only` \| `backlog_then_scratchpad` | `scratchpad_only` |
+
+**Tranche A default hot caps** (example scratchpad; explicit operator values override):
+**`STATE_HOT_MAX_LINES=1000`**, **`PO_TO_TL_HOT_MAX_LINES=650`**, **`ARCH_HOT_MAX_LINES=3000`**.
+
+#### Operator recipes
+
+| Mode | When to use | Avoid when |
+|------|-------------|------------|
+| **`standard`** | Full lifecycle, cross-cutting stories, companion DEC, release gates | N/A (default) |
+| **`ultra_lean`** | P1 stories with clear AC, token budget pressure, institutional memory needed | Mid-story mode switch; no validator/index |
+| **`mega_quick`** | ≤3 AC, single component, docs-only or tiny fix | Architecture-first; existing **`Sxxxx`**; bug segments |
+
+#### Tranche A universal wins (always-on)
+
+1. **Narrow-read** in all phase command **`Inputs`** — cite **`phase-context.md`** + story section
+   anchor; forbid full-file reads when heading exists.
+2. **Delta handoffs** — append delta paragraphs to handoff bodies; no full rewrites of prior content.
+3. **Touch-graph reads** — before **`/execute`**, read **`docs/engineering/codebase-map.md`**
+   component slice + touched paths from sprint/tasks or pack.
+
+#### `ultra_lean` E2E operator recipe (`build+verify`)
+
+1. Set **`DELIVERY_MODE=ultra_lean`**, **`LEAN_MEMORY_READ=1`**, **`LEAN_MEMORY_WRITE=1`**.
+2. Run **`/auto`** — expect four macro-phases: **`spec`**, **`plan`**, **`build+verify`**, **`ship`**.
+3. **`build+verify`** merges execute + qa + verify-work in one spawn; **`AUTO_IMPLEMENTATION_LOOP`**
+   loops inside macro-phase until green or cap.
+4. Warm memory: **`work/<story_id>/pack.json`** (validate with **`scripts/pack_json_validate.py`**).
+5. Hot index: **`handoffs/active-context.md`** (30–80 lines; **not** triad).
+
+#### Layered memory + gates
+
+- active-context.md is NOT a triad member — triad enforcement unchanged (**DEC-0054**).
+- Rollover → **`handoffs/archive/active-context-<story_id>-<utc>.md`** on oversize or segment close.
+- **`LEAN_MEMORY_READ=0`** or **`LEAN_MEMORY_WRITE=0`** on **`ultra_lean`** → **`LEAN_MEMORY_DISABLED`**.
+
+#### Quality floor (all lean modes)
+
+- Tests run before stop.
+- AC traceability in **`pack.json`** or **`task.json`**.
+- New patterns → architecture/decision delta.
+- **`active-context.md`** updated on material learnings.
+- No secrets / publish bypass (**`RELEASE_PUBLISH_MODE`** unchanged).
+
+#### Backlog routing (optional)
+
+When **`AUTO_DELIVERY_ROUTING=backlog_then_scratchpad`**, story row may declare optional
+**`delivery_mode:`** field. Precedence: argv **`delivery-mode=`** → story row → scratchpad → **`standard`**.
+
+**Release status (S0086 / US-0096)**: **`released`** (`2026-06-13T16:00:00Z`); **`US-0096`** **DONE** in canonical backlog. Operator verify: **`handoffs/releases/S0086-release-notes.md`** **## Verify**; publish skipped while **`RELEASE_PUBLISH_MODE=confirm`**.
+
 Context compaction policy:
 
 - `docs/engineering/state.md` is a compact hot surface for current execution
@@ -1398,6 +1580,27 @@ and **`docs/engineering/auto-orchestration-reference.md`** § **Native in-chat a
 | **`--invoke-cmd`** | N/A | **Required** bridge | Document in runbook |
 | **`NATIVE_CHAIN_UNAVAILABLE`** | Stops | Suggested (**optional** tone) | Non-suppressible |
 
+### BUG-0012 regression verify
+
+Multi-segment operator E2E recipe — validates native-chain orchestrator compliance
+(**DEC-0081**) after **US-0095** contract delivery.
+
+1. **Scratchpad**: set **`AUTO_FLOW_MODE=full_autonomy`**, **`AUTO_BACKLOG_DRAIN=1`**,
+   **`AUTO_BACKLOG_MAX_STORIES≥2`**, **`AUTO_QUIET=1`** in merged `.cursor/scratchpad.md`.
+2. **Backlog**: ensure **≥2 OPEN stories** in `docs/product/backlog.md`.
+3. **Invoke**: run **`/auto`** once in Cursor IDE Agent panel (no `--invoke-cmd`).
+4. **Complete segment A**: let orchestration finish **story A** through **`refresh-context`**.
+5. **Pass criteria**: orchestrator drain-advances to **story B** first phase **without**
+   operator re-**`/auto`** and **without** forbidden terminal prose (no mandatory
+   `re-run /auto`, no mandatory outer driver, no `segment exhausted` terminal when
+   continuation pending).
+6. **Evidence**: `docs/engineering/state.md` segment boundary shows
+   **`drain_advance_action=spawned`**, **`native_chain_continuing=true`**;
+   `handoffs/resume_brief.md` top pointer advances **`story_id`** to story B.
+
+Normative detail: **`.cursor/commands/auto.md`** § **Orchestrator post-subagent continuation
+mandate (BUG-0012)** and architecture **`# BUG-0012`**.
+
 ### Full-autonomy outer driver (US-0092) — fallback
 
 Opt-in **`AUTO_FLOW_MODE=full_autonomy`** (exact literal, default-off) also enables

package/template/scripts/check_intake_template_parity.py

@@ -9,6 +9,10 @@ Scoped modes (DEC-0073 §10 / US-0090):
   --scope=us-0092               DEC-0078 full-autonomy outer driver + probe surfaces.
   --scope=us-0093               DEC-0079 browser UAT probe surfaces.
   --scope=us-0095               DEC-0080 native in-chat auto-chain surfaces.
+  --scope=bug-0012              DEC-0081 native-chain compliance surfaces (BUG-0012).
+  --scope=us-0096               DEC-0082 delivery modes surfaces (US-0096).
+  --scope=project-readme        DEC-0083 project README bootstrap surfaces (US-0097).
+  --scope=dev-environment       DEC-0084 dev auto-launch profile surfaces (US-0098).
   --scope=all              union of all tables.
 """
 
@@ -114,6 +118,90 @@ US0095_PAIRS: tuple[tuple[str, str], ...] = (
     ),
 )
 
+BUG0012_PAIRS: tuple[tuple[str, str], ...] = (
+    (".cursor/commands/auto.md", "template/.cursor/commands/auto.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+US0096_PAIRS: tuple[tuple[str, str], ...] = (
+    (
+        ".cursor/scratchpad.local.example.md",
+        "template/.cursor/scratchpad.local.example.md",
+    ),
+    (".cursor/commands/auto.md", "template/.cursor/commands/auto.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (".cursor/commands/quick.md", "template/.cursor/commands/quick.md"),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+    ("scripts/pack_json_validate.py", "template/scripts/pack_json_validate.py"),
+)
+
+PROJECT_README_PAIRS: tuple[tuple[str, str], ...] = (
+    (
+        "scripts/validate_project_readme_coverage.py",
+        "template/scripts/validate_project_readme_coverage.py",
+    ),
+    (
+        "scripts/project_readme_coverage_lib.py",
+        "template/scripts/project_readme_coverage_lib.py",
+    ),
+    (".cursor/commands/execute.md", "template/.cursor/commands/execute.md"),
+    (".cursor/commands/release.md", "template/.cursor/commands/release.md"),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "docs/engineering/context/installer-owned-paths.manifest",
+        "template/docs/engineering/context/installer-owned-paths.manifest",
+    ),
+    (
+        ".cursor/scratchpad.local.example.md",
+        "template/.cursor/scratchpad.local.example.md",
+    ),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+DEV_ENVIRONMENT_PAIRS: tuple[tuple[str, str], ...] = (
+    (".cursor/commands/execute.md", "template/.cursor/commands/execute.md"),
+    (".cursor/scratchpad.md", "template/.cursor/scratchpad.md"),
+    (
+        ".cursor/scratchpad.local.example.md",
+        "template/.cursor/scratchpad.local.example.md",
+    ),
+    (
+        "template/.cursor/dev-environment.json.example",
+        "template/.cursor/dev-environment.json.example",
+    ),
+    (
+        "scripts/dev_environment_lib.py",
+        "template/scripts/dev_environment_lib.py",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
 DOWNSTREAM_CI_GUARD_PAIRS: tuple[tuple[str, str], ...] = (
     (
         "scripts/check_downstream_ci_guard.py",
@@ -133,6 +221,10 @@ SCOPES: dict[str, tuple[tuple[str, str], ...]] = {
     "us-0092": US0092_PAIRS,
     "us-0093": US0093_PAIRS,
     "us-0095": US0095_PAIRS,
+    "bug-0012": BUG0012_PAIRS,
+    "us-0096": US0096_PAIRS,
+    "project-readme": PROJECT_README_PAIRS,
+    "dev-environment": DEV_ENVIRONMENT_PAIRS,
     "all": (
         INTAKE_TEMPLATE_PAIRS
         + CAVEMAN_COMPRESS_PAIRS
@@ -141,6 +233,10 @@ SCOPES: dict[str, tuple[tuple[str, str], ...]] = {
         + US0092_PAIRS
         + US0093_PAIRS
         + US0095_PAIRS
+        + BUG0012_PAIRS
+        + US0096_PAIRS
+        + PROJECT_README_PAIRS
+        + DEV_ENVIRONMENT_PAIRS
     ),
 }