mainframe-pi-engineer

Pi engineer

Keep architecture, user communication, final review, and the commit in this primary task. Pi implements one already-agreed block in the current Git worktree and returns structured evidence; its internal verifier is a quality gate, not final acceptance.

For a new block, write a short JSON request inside .agents/runtime/pi/requests/ with this exact shape:

{
  "schemaVersion": 1,
  "goal": "One observable result",
  "writePaths": ["path/or/narrow-glob"],
  "excludePaths": [],
  "invariants": ["Behavior that must remain true"],
  "acceptance": ["Concrete result that can be checked"],
  "forbiddenFutureStages": ["Later work that must not begin"],
  "checks": [{"argv": ["exact-executable", "arg"], "timeoutMs": 60000}]
}

Keep lists only as detailed as the block requires. Checks must be exact argv, not inline shell, and cannot invoke Git. Run mainframe-pi engineer --mode new --request <project-relative-request.json>.

For a correction to the same active block, write a packet containing exactly instructions, missingEvidence, and failedCheckIds arrays, then run mainframe-pi engineer --mode resume --feedback <project-relative-feedback.json>. Omit --feedback only when resuming interrupted work without new review findings.

Let a run finish unless it reports a real block. Inspect the returned status, changed paths, checks, acceptance evidence, and verifier verdict against the actual diff. ready-for-architect-review means only that Pi's internal pass is complete. Send an in-scope defect back as one precise resume correction. Once accepted, create the Conventional Commit here, limited to accepted task paths and preserving unrelated dirty or staged work. The next new block reconciles that commit and compacts the persistent Pi session.

Do not copy Pi's internal pipeline into the prompt, pass profile/config/project overrides, ask Pi to commit, or treat its verifier as user acceptance.