📝text•6 months ago
Improvement Cycle Review Wizard
Run a live improvement-cycle workflow that links review artifacts, approvals, tool requests, and operator checkpoints.
productivity
⭐1
# Improvement Cycle Review Wizard
Imported from curated first-party documentation sources.
## What this covers
Use this workflow when an operator needs a guided improvement cycle with live status, explicit approvals, and linked artifacts.
## Use this when
- Operational review sessions with live progress
- Approval-heavy improvement cycles
- Coordinating review artifacts with execution steps
## Expected outcomes
- Live workflow execution remains visible to operators
- Artifacts, approvals, and tool requests stay connected
- Improvement loops become easier to audit and rerun
## Source synthesis
- AGENT33/docs/phase25-26-live-review-walkthrough.md (https://github.com/mattmre/AGENT33/blob/main/docs/phase25-26-live-review-walkthrough.md)
- AGENT33/docs/operator-improvement-cycle-and-jupyter.md (https://github.com/mattmre/AGENT33/blob/main/docs/operator-improvement-cycle-and-jupyter.md)
## Dedupe notes
Merges AGENT33 live review walkthrough details with the shorter operator-focused improvement-cycle guide.
## Source excerpts
### AGENT33/docs/phase25-26-live-review-walkthrough.md
This guide documents the operator flow introduced by the Phase 25 live workflow transport and the Phase 26/27 improvement-cycle review wizard stack.
## Scope
- Live workflow execution with run-scoped graph refresh
- WebSocket-first status streaming with authenticated SSE fallback
- Improvement-cycle preset creation
- Explanation artifact generation for `plan_review` and `diff_review`
- Linked review creation, risk assessment, L1/L2 signoff, and final approval
- Pending tool-approval triage inside the same workflow domain
> Note
> This walkthrough reflects the review stack built on `codex/session58-phase26-wizard` and validated in `codex/session60-phase22-docs-validation`. If the related PRs are still open, `main` may not yet expose every surface described here.
## Operator Flow
```mermaid
sequenceDiagram
participant UI as "Frontend Control Plane"
participant WF as "Workflow APIs"
participant VIZ as "Visualization APIs"
participant EXP as "Explanation APIs"
participant REV as "Review APIs"
participant HITL as "Tool Approval APIs"
UI->>WF: "POST /v1/workflows/{name}/execute (single mode, caller run_id)"
UI->>VIZ: "GET /v1/visualizations/workflows/{workflow_id}/graph?run_id=..."
UI->>WF: "WS /v1/workflows/{run_id}/ws"
alt "WebSocket unav
...
### AGENT33/docs/operator-improvement-cycle-and-jupyter.md
This guide covers the merged operator surfaces for:
- the Phase 26 improvement-cycle review wizard
- the Phase 27 canonical workflow presets
- the Phase 38 Docker-backed Jupyter kernel workflow
Use it when you want the shortest current path from UI entry point to a real workflow run.
## 1. Improvement-Cycle Wizard
The wizard is mounted inside the frontend control plane under the `Workflows` domain.
### Entry path
1. Open the frontend at `http://localhost:3000`
2. Authenticate with a bearer token or API key
3. Open `Advanced Settings`
4. Select the `Workflows` domain
5. Use the `Improvement Cycle Wizard` panel at the top of the page
### What the wizard does
The wizard stitches together the backend surfaces that previously had to be called manually:
- plan review / diff review generation
- review creation and risk assessment
- L1 and L2 review submission
- tool approval request review and decision capture
Reference implementation:
- frontend: `frontend/src/features/improvement-cycle/ImprovementCycleWizard.tsx`
- tests: `frontend/src/features/improvement-cycle/ImprovementCycleWizard.test.tsx`
For the detailed review flow, keep using:
- [`phase25-26-live-review-walkthrough.md`](phase25-26-live-review-walkthrough.md)
## 2. Canonical Workflow Presets
The `Workflows` doma
...
👍0
👁️0
docs