cyberneticlibrary

Review and approve plans before implementation

plan-reviewcommandsetup L35,331
backnotprop/plannotator
What it does

Review and approve plans with structured feedback

Best for

Multi-turn agent workflows where a human must review a plan before expensive implementation decisions are locked in.

Inputs
  • · Agent plan (as JSON in stdin)
  • · User annotations (deletion, comment, label)
Outputs
  • · Approved plan with agent proceeding to implementation
  • · Structured feedback to agent for revision
  • · Plan diff showing what changed between revisions
Requires
  • · Bun server
  • · Browser for UI
  • · Agent integration (ExitPlanMode or Codex Stop hook)
Preconditions
  • · Agent reaches plan handoff point
  • · Permission hook configured in hooks.json
  • · Browser available
Failure modes
  • · Codex integration is post-render, not pre-submit (asymmetry with Claude Code)
  • · Images stored as temporary files (not persisted)
  • · No approval-with-annotations for Claude Code (warning dialog)
Trust signals
  • · Hooks into both Claude Code and Codex (agent framework integration)
  • · Plan diff view shows what changed between revisions
  • · Five annotation types (delete, comment, label, approval, global)
  • · Image attachments with markup support
  • · Revision loop with structured feedback