Skip to content

docs(model-config): Setup A precise semantics — driver-swap escalation + advisor subagent fallback (#440 follow-up) - #446

Merged
BaseInfinity merged 2 commits into
mainfrom
docs/setup-a-clarity
Jul 15, 2026
Merged

docs(model-config): Setup A precise semantics — driver-swap escalation + advisor subagent fallback (#440 follow-up)#446
BaseInfinity merged 2 commits into
mainfrom
docs/setup-a-clarity

Conversation

@BaseInfinity

Copy link
Copy Markdown
Owner

Why

Maintainer ask (2026-07-13): Setup A's semantics kept getting re-confused — "Sonnet 5 high or xhigh?", "escalation means what exactly?", "advisor failed, now what?". This PR makes the answers impossible to miss, each with its why. Pure clarity restatement of #440/#439-certified decisions — introduces no new factual claims.

What

  • README — new Reading Setup A precisely section: effort escalation stays inside the Sonnet 5 driver (medium default); model escalation swaps the driver to Opus 4.8 xhigh (2 failures / LOW confidence / high-stakes); advisor failure → spawn a Fable subagent, never skip.
  • AI_SETUP_LANES — Setup A escalation row spelled out; Two escalation axes + Advisor failure has a fallback paragraphs; outage procedure Step 2 rewritten — it still offered a "continue with no advisor" path contradicting the rule two sections above it (Codex round-1 P1).
  • teststest_setup_a_escalation_and_advisor_fallback_explicit: positive assertions + section-scoped negative half so the skip-path can't silently return (RED-first, mutation-verified). CC version drift: baseline v2.1.195, latest v2.1.207 (12-release gap) #439 reviewer-model line pins re-shifted +4, each verified against real content.
  • ROADMAP — parking lot: rename-research row added (wizard → harness, workshop later, expiry 2026-09-11); /insights with Fable row closed as TRIGGER FIRED 2026-07-13.

Review trail

Codex xhigh (GPT-5.6 Sol), 3 rounds to CERTIFIED — 5 real findings across rounds, all fixed via the dialogue loop. Doc-consistency suite: 72/72.

…n + advisor subagent fallback (#440 follow-up)

Maintainer ask 2026-07-13: Setup A's semantics kept getting re-confused
(effort ladder vs model escalation; what happens when advisor() fails).
Clarity restatement of already-certified decisions — no new claims.

- README: new 'Reading Setup A precisely' section — three rules, each
  with its why: effort escalation stays inside the Sonnet 5 driver
  (medium default per #440), model escalation SWAPS the driver to
  Opus 4.8 xhigh (2 failures / LOW confidence / high-stakes), advisor
  failure falls back to a Fable subagent, never to skipping
- AI_SETUP_LANES: Setup A escalation row + 'Two escalation axes' and
  'Advisor failure has a fallback' paragraphs; outage procedure Step 2
  rewritten — swap the transport, not the check (Codex round-1 P1: it
  still offered a 'no advisor' path, contradicting the new rule)
- tests: new test_setup_a_escalation_and_advisor_fallback_explicit
  (positive + section-scoped negative half, RED-first, mutation-
  verified); #439 reviewer-model pins re-shifted +4 after insertion
- ROADMAP: parking lot — rename-research row added (wizard->harness,
  workshop later, expiry 2026-09-11); /insights row closed as fired

Cross-model review: Codex xhigh (GPT-5.6 Sol), 3 rounds to CERTIFIED —
5 findings total (skip-path contradiction, outcome-guarantee and
superlative overclaims, false-green test gap), all fixed.
Doc-consistency suite: 72/72.
@BaseInfinity
BaseInfinity merged commit 4d0197a into main Jul 15, 2026
4 checks passed
BaseInfinity added a commit that referenced this pull request Jul 15, 2026
…net 5 medium default (#448)

Catch-up release: seven consumer-affecting commits were stranded on main
since v1.86.0 (July 5) because nothing prompts the manual tag-to-publish
step — most urgently #445, the Copilot CLI argument-hint fix from the
repo's first external contributor (@thejesh23), which npm consumers were
not receiving.

- CHANGELOG [1.87.0]: leads with the first-external-contribution credit;
  covers #441 (GPT-5.6 Sol reviewer sweep), #443 (Sonnet 5 medium default,
  unbacked 5x quota claim removed, hook floor), #445/#447 (Copilot fix +
  regression test), #446 (Setup A semantics), #440/#442 (chores)
- Version bumps at all sites found by the broad grep (v1.85.0 lesson)
- ROADMAP #448 (Copilot CLI compat watch) + #449 (release-drift gate —
  this incident's post-mortem; scope: own-package npm-vs-main watcher)
- skills/update: [1.87.0] example line; two oldest bullets trimmed to
  stay under the 20K session-load cap

Cross-model release review: Codex xhigh (GPT-5.6 Sol), 3 rounds to
CERTIFIED — caught a sed-falsified historical version citation and two
unsupported duration claims in my own incident narrative. All suites
green.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant