ContextQMD
Back to Everything Claude Code

Plan Canvas Command

commands/plan-canvas.md

2.1.01.5 KB
Original Source

Plan Canvas Command

Opens a local artifact in the Plan Canvas — ECC's browser review surface — where the user annotates elements, chats with you, and approves the plan or requests changes without leaving the page.

This command is a thin entry point over the plan-canvas skill. Follow that skill for the full workflow and rules.

What This Command Does

  1. Resolve the artifact: the given path, else the most recently modified .claude/plans/*.plan.md, else ask what to review.
  2. ecc-plan-canvas open <artifact> — opens the user's browser.
  3. ecc-plan-canvas await <artifact> — block until feedback, verdict, or session end; leave it running.
  4. Apply feedback to the artifact file (the canvas live-reloads), answer with await <artifact> --reply "...", and repeat until the user approves or ends the session.

An approve verdict counts as plan confirmation for /plan-style gates: stop polling, end the session, and begin implementation.

Example

User: /plan-canvas .claude/plans/notifications.plan.md

Assistant: (runs open + await, browser opens)
...user clicks "Request changes" with two annotations...
Assistant: (edits the plan, replies in-canvas, awaits again)
...user clicks "Approve plan"...
Assistant: Plan approved in the canvas — starting implementation.
  • plan-canvas skill — full workflow, feedback JSON shapes, rules
  • /plan — produces the plan artifacts this reviews
  • Source: scripts/plan-canvas.js, scripts/lib/plan-canvas/