ForgeFlow / User guide

ForgeFlow / Reference

Roadmap

Release 4.7.0 checkpoint

The capability foundation and review runtime are packaged in 4.7.0. E2 immutable evidence, E4 ready-or-blocked preparation, E5 scoped adoption decisions and E6 assessed on-demand use are complete. E3 bounded follow-up is implemented; its broader quality/cost qualification remains experimental. See review and execution, the portable roadmap and release notes for the current state. The earlier measurement and queued-plan descriptions below retain their historical context. No completed or stopped study is restarted.

ForgeFlow is a software delivery workshop for Claude Code and Codex. This page records product direction; it does not promise dates or imply that deferred work is implemented.

Available Today

The core delivery phases, specialist agents, local project memory, and evidence-based review are joined by the workshop dashboard and Ember. The dashboard balances reported activity, project readiness, context budget, and recorded review outcomes. Supported workflow entrypoints open it once per eligible desktop session. The visual guide and Quick Start cover first use.

Current Priorities

  1. Keep install, repair, and release paths trustworthy.
  2. Keep review, audit, and context-prep surfaces evidence-backed.
  3. Reduce onboarding friction for Claude Code and Codex without broadening automation risk.
  4. Keep public docs and runtime behavior aligned.

Retained Measurement Checkpoint

Updated October 1, 2026. F6.1 is complete as bounded measurement and supported-workflow qualification. The final checks verify all six retained receipt clean controls, matching original requested model/settings across 45 stage/correction records, retained consequential claims and one complete supported Codex lifecycle. The 33 current acceptance checks, 21 historical checks, 55 unchanged controller tests, four focused tests and all five source-bound task criteria pass without waivers.

The original automated comparison remains baseline 6/6 versus recovery 3/6, with two timeouts and one usage interruption; its three correction intervals exclude the six-day administrative pause. The stopped comparison retains 22 finished, two interrupted and twelve unlaunched attempts. Historical scores and diagnostics are unchanged. Reused-case, synthetic/local and provider-default limits remain explicit; no general benefit follows.

F6.2 retains all nine capabilities in evaluation, F6.3 passes 222 local test commands and managed integration checks, and F6.4 prepares the source-release summary. At that checkpoint, normal activation and packaged publication remained pending. The 4.7.0 release and E6 assessed-use policy are described above. E1 case and decision-contract preparation is complete; E2 immutable review evidence is complete, including seven evidence-flow observations on owned PR #33 and 67 scoped PR checks; E3 — Focused specialist questions and bounded follow-up is implemented with a bounded real-PR walkthrough; quality/independence and comparative overhead acceptance remain open. See the checkpoint. See the portable roadmap and resumption status.

Active Work Themes

Install And Runtime Confidence

Review And Context Quality

Onboarding And Adoption Evidence

Release And Documentation Discipline

Queued: Review And Execution Evolution

Status: E1 and E2 are complete; E3 bounded follow-up is implemented with broader qualification held; E4 functional preparation, E5 scoped adoption decisions and E6 assessed on-demand authority are complete. The portable roadmap tracks E1–E6. Existing permissions and required acceptance checks retain precedence.

The phased review and execution plan draws on Jive's execution and decision design. It builds on ForgeFlow's existing PR experience, specialist reviews, routing, context packets, and source-bound task evidence.

  1. Define the pilot and evidence contract. Select representative historical review cases, record the current baseline, and specify consequential claims, assumptions, missing evidence, and adoption criteria.
  2. Preserve exact evidence across handoffs. Give review inputs and results immutable run identities, bounded previews, full retrieval paths, and explicit freshness and coverage.
  3. Focus specialist work and challenge assumptions. Assign concrete review questions, support bounded requests for missing evidence, and independently challenge important approval premises when risk warrants it.
  4. Execute deterministic review preparation. Connect existing scope, packet, budget, and wave helpers through the ordinary review entrypoint. Keep judgment with specialists and preserve native authorization and interruption handling.
  5. Compare outcomes and adopt selectively. Replay the historical cases with frozen inputs, measure correctness and coordination cost, and retain only improvements supported by the results. Consider bounded model decisions only if a measured workload justifies them.

Each phase has deliverables, dependencies, and exit criteria in the plan. A general graph runtime, replacement agent architecture, eager execution of streamed plans, and a new model-provider dependency remain deferred. Historical cases and measured run evidence stay local; public summaries omit private project details.

Deferred By Default

The following stay out of scope unless new evidence justifies them:

How To Prioritize New Work