claudegoodies
Skill

plan-canvas

From affaan-m

Open plans and HTML artifacts in a local browser canvas where the human annotates elements, chats, and approves or requests changes without leaving the page. Use when presenting a plan for review, or when feedback like "move this, change that" is easier pointed at than typed.

Opens local plan/HTML artifacts in a browser canvas so a human can annotate, chat, and approve/request-changes via a blocking CLI loop.

Use it when

  • Presenting a `.plan.md` from `/plan` and need an approve/request-changes verdict
  • Reviewer wants to point at a specific element instead of typing feedback
  • Plan includes flowcharts/architecture/sequence diagrams via Mermaid blocks
  • Reviewing local design comparisons or reports as `.md`/`.html` files

Skip it if

  • Only local artifact files are supported, not remote URLs or running web apps
  • Not for code diff review (use /code-review instead)
  • Requires the ecc-universal package's ecc-plan-canvas CLI on PATH or plugin script path

Facts

Repository
affaan-m/ECC
Status
Actively maintained
Last commit
Source file
.agents/skills/plan-canvas/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# Plan Canvas

Review loop for plans and visual artifacts: you write the artifact, the human
reviews it in the browser — annotating the exact element they mean, chatting,
and delivering an **Approve plan / Request changes** verdict — while you block
on a single CLI call that returns their feedback as JSON.

Inspired by [lavish-axi](https://github.com/kunchenguid/lavish-axi); rebuilt
ECC-native around the `/plan` confirmation gate, with zero dependencies.

## When to Use

- You just wrote a plan artifact (`.claude/plans/*.plan.md` from `/plan`) and
  need the CONFIRM/approve decision — the canvas verdict replaces a typed
  "yes/proceed".
- The user should *point at* what to change: reviewing designs, comparisons,
  reports, or any local `.md` / `.html` artifact.
- The user asks for `/plan-canvas`, a visual review, or "open it in the browser".

Do NOT use for: code review of diffs (`/code-review`), running web apps, or
remote URLs. The canvas serves local artifact files only.

## How It Works

Invoke the CLI as `ecc-plan-canvas` — the bin shipped by the `ecc-universal`
package (on PATH after a global/plugin install; `node "$CLAUDE_PLUGIN_ROOT/scripts/plan-canvas.js"`
also works for plugin installs). Run it from the project you are reviewing in;
it works from any working directory. It manages a detached loopback server
(`127.0.0.1:4517`) shared by all sessions, keyed by artifact p
View full source on GitHub →

Other skills