parallel-fix

Parallel Fix

Speed up the fix/implement half of the loop. A normal agent fixes a list serially (explore → fix → test → commit, repeat) — slow. This skill generates every fix concurrently, then integrates + verifies once.

Engine / backend / sandbox / journal mechanics: reuse the dynamic-workflow skill. This skill carries only the method.

The key idea (and its honest limit)

The slow, parallelizable part is "analyze each finding + write the correct patch" — independent per finding. So fixers run in parallel but READ-ONLY, each returning a unified diff (not editing the tree — parallel writers to one repo race and the engine will reject them). A single serial step then applies the diffs, resolves conflicts, and runs the full suite once.

Honest limits — say these to the user, don't hide them:

• Integration + verify is serial (one suite run on the merged result) — that's the bottleneck you can't parallelize away.
• Overlapping fixes (same file/lines) can't be blindly merged — the apply step puts conflicts in a conflicted list for manual handling.
• Parallel fixers don't see each other, so a fix may assume code another changed — the single full-suite verify catches breakage; a reconciliation pass may be needed.
• Realistic speedup ≈ 2–4× (more independent findings → more speedup), NOT N×.

Steps

Generate .codex-flow/generated/<slug>.fix.workflow.ts from references/fix-template.workflow.ts (import-free, plain JSON Schema), set FINDINGS to the real list (from the audit / the user), then codex-flow run it. The phases:

1. Propose (parallel, sandbox: "read-only") — one agent per finding. Each reads the code and returns the smallest correct unified diff + a risk rating. Read-only ⇒ safe to share one cwd. Route risk: "high" items (concurrency / resume / budget / determinism) out of the blind-parallel path — recommend the user fix those with single careful TDD (a reproducing test first), because that's where parallel-blind fixes regress.
2. Apply + verify (phase, single agent, sandbox: "workspace-write", cwd: process.cwd()) — apply the diffs in a conflict-minimizing order; record un-mergeable ones under conflicted; run the project's full test + typecheck once; report testPassed honestly.