Skip to content

v5.6.0 — Fable→Opus + reviewer context wiring (incl. v5.5.0 hybrid Workflow acceleration) - #81

Merged
egerev merged 3 commits into
mainfrom
feat/workflow-hybrid-v5.5
Jun 30, 2026
Merged

v5.6.0 — Fable→Opus + reviewer context wiring (incl. v5.5.0 hybrid Workflow acceleration)#81
egerev merged 3 commits into
mainfrom
feat/workflow-hybrid-v5.5

Conversation

@egerev

@egerev egerev commented Jun 11, 2026

Copy link
Copy Markdown
Owner

Summary

Hybrid (not a rewrite): the markdown DAG and Agent-based dispatch stay the default everywhere and the only path on Codex runtime. Two opt-in saved workflows accelerate the hottest Phase 2 fan-outs, and Phase 2 launch now suggests a /goal watchdog.

Saved workflows (deployed to ~/.claude/workflows/ via the v5.4.0 checksum sync)

  • /superflow-review — unified review fan-out: product + technical reviewers in parallel; fenced-JSON verdicts parsed fail-closed in the script; pass computed in code, not model memory. workdir arg makes codex review the sprint worktree checkout (not the repo root); product: false handles light-governance single-reviewer cells. Provider value: workflow-review.
  • /superflow-wave — implementation-only parallel wave per the v5.4.0 dispatch rule; orchestrator keeps review → docs → PAR → ship per sprint.

references/workflow-orchestration.md — single Workflow authority

Documented API facts with official-doc citations, opt-in policy, permission gates by mode, limits, runtime conventions verified by live smoke runs (top-level script body, parallel(thunks), meta pure literal, args may arrive as a JSON string → normalization required), an UNDOCUMENTED-API warning box, the /goal watchdog section, and the Codex fallback chain.

Integration

  • context.use_workflows opt-in captured at Phase 1 plan approval (state + Autonomy Charter), with an honest permission-mode heads-up.
  • Phase 2 launch prints a ready-to-paste /goal suggestion (user-only command — documented as such; subagent goal-direction remains charter injection).
  • Codex runtime untouched: no Workflow tool, no /goal — existing spawn_agent paths.

Test plan

  • Live smoke run, fail-closed path: /superflow-review with empty args → instant {pass: false, error: "missing required args: …"}, 0 agents, 12 ms
  • Live smoke run, full pipeline: /superflow-wave with a fake sprint → 1 agent dispatched, fenced JSON parsed, position-bound result returned exactly per contract
  • Live probe: confirmed args arrive as a JSON string → defensive normalization shipped in both scripts
  • tools/verify-phase2-dag.sh 33/33 PASS; jq schema checks; llms.txt line counts swept
  • Dual review (technical + coherence) → fixes → scoped re-review APPROVE
  • CI green on this PR

🤖 Generated with Claude Code

egerev and others added 3 commits June 11, 2026 13:06
Opt-in saved workflows (deployed to ~/.claude/workflows/ via checksum sync):
- /superflow-review: unified review fan-out (product + technical in parallel,
  fenced-JSON verdicts, fail-closed parsing, light-mode product:false,
  codex runs inside the sprint worktree via workdir arg)
- /superflow-wave: implementation-only parallel wave; orchestrator keeps
  review/docs/PAR/ship per sprint

references/workflow-orchestration.md is the single Workflow authority:
documented API surface, opt-in policy, permission gates by mode, limits,
runtime conventions verified by live smoke runs (top-level body,
parallel(thunks), meta pure literal, args may arrive as a JSON string),
undocumented-API warning, /goal watchdog, Codex fallback chain.

Integration: context.use_workflows opt-in at Phase 1 plan approval (state +
charter); /goal ready-to-paste suggestion at Phase 2 launch (user-only command,
honestly documented); provider enum gains workflow-review; Codex runtime
unaffected (no Workflow tool, no /goal — existing spawn_agent paths).

Verification: live smoke runs of both scripts (fail-closed path: 0 agents/12ms;
full pipeline: 1 agent, parsed position-bound result); DAG verify 33/33;
dual review -> fixes -> scoped re-review APPROVE.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Fable access is blocked. All deep judgment roles (deep spec/code/product
reviewers + deep-analyst) move model: fable -> opus; depth differentiated
by effort (deep=max, standard=high). Implementers stay on Sonnet —
deliberately not pushed into judgment roles.

- Remove the model_profile selection entirely (Phase 1 Step 2c, state
  schema, charter frontmatter, plan recap, all dispatch docs).
- Pin every Claude secondary to claude-opus-4-8 (SKILL.md, codex/AGENTS.md,
  codex dispatch patterns + phase overlays); PAR provider strings updated.
- Fix stale "inherits Fable" warnings -> inherits the orchestrator session
  model (Opus).

Reviewer context wiring (spec/plan/charter actually reach reviewers):
- code-reviewer (deep+standard+mirror) gains <spec_or_plan> + <autonomy_charter>
  slots; product-reviewer gains <product_brief> + <autonomy_charter>.
- /superflow-review takes optional spec_path/plan_path/brief_path, wired into
  both lenses; missing inputs flagged unverifiable, not passed silently.
- review-unified.md dispatch contract made explicit.

Deployed copies synced to ~/.claude and ~/.codex. CI forbidden-token gate
hardening is split into a follow-up commit (needs GitHub `workflow` scope).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…claude-opus-4-8

Regression guard so the blocked Fable model cannot be reintroduced. Pushing
this requires the GitHub `workflow` OAuth scope.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@egerev egerev changed the title v5.5.0 — hybrid Workflow acceleration + /goal watchdog for Phase 2 v5.6.0 — Fable→Opus + reviewer context wiring (incl. v5.5.0 hybrid Workflow acceleration) Jun 30, 2026
@egerev

egerev commented Jun 30, 2026

Copy link
Copy Markdown
Owner Author

v5.6.0 added on top of this branch

Fable access blocked → Opus everywhere

  • Deep judgment roles (deep-spec/code/product-reviewer, deep-analyst): model: fablemodel: opus; depth now differentiated by effort (deep=max, standard=high). Implementers stay on Sonnet.
  • model_profile selection removed (Phase 1 Step 2c, state schema, charter, plan recap, all dispatch docs).
  • Every Claude secondary pinned to claude-opus-4-8; stale "inherits Fable" warnings corrected.

Reviewer context wiring

  • code-reviewer gains <spec_or_plan> + <autonomy_charter> slots; product-reviewer gains <product_brief> + <autonomy_charter> — the plan-completeness/charter checks finally have structured inputs.
  • /superflow-review takes optional spec_path/plan_path/brief_path, wired into both lenses; missing inputs flagged unverifiable.
  • review-unified.md dispatch contract made explicit.

⚠️ One follow-up commit (CI forbidden-token gate: add claude-fable-5 guard + fix pin message) is held locally — pushing a .github/workflows/ change needs the workflow OAuth scope. Will push once granted.

@egerev

egerev commented Jun 30, 2026

Copy link
Copy Markdown
Owner Author

✅ Follow-up c255f79 landed — CI forbidden-token gate now also blocks the Fable model pin and the message reflects the claude-opus-4-8 pin. v5.6.0 fully on the branch.

@egerev
egerev merged commit 5597369 into main Jun 30, 2026
1 check passed
@egerev
egerev deleted the feat/workflow-hybrid-v5.5 branch June 30, 2026 09:07
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