Polymath Zero

Docs · Working a case

Run a planning session

A planning session is the first session for a new problem. The AI forms a hypothesis and proposes a plan. You approve or modify before execution begins.

Steps

  1. Open the case. State should be OPEN or INVESTIGATING.
  2. Click New session → select Plan.
  3. Describe what you know — symptoms, repro steps, prior investigation. Added to session context.
  4. Zero begins. It traces code paths, reads case memory, and forms a hypothesis.
  5. Session ends with a proposed plan: hypothesis, suggested fix approach, required tests.
  6. Review the plan. Approve, reject, or add notes before execution.
  7. Approve → case moves to IMPLEMENTING. Reject → session is logged; start a new one.

Session lifecycle

01
Context load
Zero reads case memory: problem-definition.md, prior session logs, code context.
INVESTIGATING
02
Hypothesis
Agent forms a hypothesis about root cause.
INVESTIGATING
03
Plan
Agent proposes fix approach and required tests.
INVESTIGATING
04
Approval gate
Operator reviews the plan and approves or rejects.
INVESTIGATING
05
Execution
Agent applies the fix and runs tests.
IMPLEMENTING
06
Output
Diff, test results, and evidence logged to the session record.
VERIFYING
07
Proof decision
Operator decides whether output qualifies as proof.
VERIFYING

Approval is mandatory

Zero never executes code changes without an approved plan. The approval step cannot be bypassed.