Docs

Review, converge & merge

Recoder's headline flow: take N parallel agent runs and turn them into one reviewed, governed commit with signed evidence.

This is Recoder's headline flow: take N parallel agent runs and turn them into one reviewed, governed commit.

1. Compare

Open Compare for a task group. You get side-by-side diffs of each agent's worktree against the base, the contested files (paths more than one agent changed), readiness / mergeability signals, and pairwise A/B comparison when you want to weigh two agents head-to-head.

2. Converge

Open Converge. Recoder builds a convergence plan:

  • •Non-contested files are taken automatically from whichever agent changed them.
  • •Pick — take one agent's version of a contested file wholesale. Safe and obvious when one agent clearly did it right.
  • •Synthesize — merge non-overlapping edits from multiple agents using a 3-way merge (git merge-file semantics; for more than two agents it folds them pairwise). If two agents edited the same lines in a way that truly conflicts, Recoder marks it a conflict and aborts that file rather than writing conflict markers — you won't get a silently broken merge.

Provenance is recorded. For every file, Recoder remembers which agent won and whether it was a pick or a synthesize. That provenance goes into the evidence record.

3. Governed merge

Land the converged branch. Before any git write happens, the merge passes the governance gate: allowed → it merges (falling back to a local git merge when there's no remote/gh); needs approval → it waits for a human decision; denied → it stops and tells you why. Every outcome is sealed into the tamper-evident audit chain.

The evidence you get

A successful governed merge produces a ConvergenceEvidence record: the task and each candidate agent's diff, the governance verdict and any approval, verification results, per-file provenance (which agent contributed each path, pick vs synthesize), a SHA-256 content hash, and an Ed25519 signature when a signing key is configured. You can export a compliance pack mapping the evidence to SOC 2, EU AI Act, DORA, and Recoder's own convergence-integrity control — each status derived from present evidence, never a fabricated “met.”