Skip to content
Development
Command

/annotate-plan

Draft a plan and open it in the annotator UI for user review

From plugin
open-plan-annotator
991 skill1 command3 hooks
> /plugin marketplace add ndom91/open-plan-annotator
> /plugin install open-plan-annotator@open-plan-annotator

Command definition

annotate-plan.md
description: Draft a plan and open it in the annotator UI for user review
argument-hint: [task description]

The user wants a plan drafted and reviewed via the open-plan-annotator UI before any implementation. This is required, not optional.

**Task to plan:** $ARGUMENTS

Steps:

1. Enter plan mode (`EnterPlanMode`). 2. Investigate the codebase as needed to draft a concrete plan. Include:

  • Brief summary of what you understood the task to require
  • Specific files you intend to create or modify and why
  • Any assumptions you are making
  • Tradeoffs and option comparisons inline (do NOT pull these into chat — they belong in the plan body where the user can comment on each one)
  • Explicit questions if anything is ambiguous

3. Call `ExitPlanMode` with the plan. This triggers the open-plan-annotator browser UI. 4. The user will annotate the plan (deletions, replacements, insertions, comments) in the browser. 5. If the user denies with annotations, revise the plan based on their feedback and re-exit plan mode. 6. Only begin implementation after the user approves.

Hard rules:

  • Do not skip plan mode.
  • Do not paste a plan inline and ask "sound good?" — that bypasses the annotator UI the user installed this plugin for.
  • Do not collapse into a 2-3 sentence inline response just because the user message contains an exploratory clause like "what do you think?" alongside directive items. Mixed signals still route through the annotator.
  • Self-check the response before sending: if it contains a "Plan:" / "Steps:" / "Concrete changes:" header, 3+ file paths, or ends with "OK to proceed?" — discard and route through the annotator instead.
Read more
@ndom91
Ships withopen-plan-annotator

A fully local agentic coding plugin that intercepts plan mode and opens an annotation UI in your browser. Mark up the plan, send structured feedback to the agent, and receive a revised version — iterate as many times as you need until you're ready to approve.

Stars on GitHub

Momentum

stars in total
99
Star history of ndom91/open-plan-annotator on GitHub, a chart by star-history.com

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command