Back to What I want to exist

Existence file

refined-plan-mode

A local review app and protocol for AI coding-agent plans. It exists because long plans need the same kind of anchored, reviewable feedback loop that pull requests give code.

Goal

Turn agent plans into versioned local artifacts with browser-based line, range, and text-selection comments, structured feedback files, and an explicit approval gate before implementation.

  • TypeScript
  • AI Agents
  • Review Tools

Now

Where it is

The MVP can read versioned Markdown plans, render them in a browser reviewer, persist draft comments, submit JSON feedback, and mark a plan approved through the .plan-review file convention.

Next

What comes next

  • Solidify the local review loop around versioned plans, anchored comments, JSON feedback, and approval.
  • Make the reviewer UI faster and more natural for repeated plan review.
  • Keep Codex, Claude Code, and future harness integrations behaviorally consistent around the same file protocol.