Plan Review — VS Code Extension

Review AI-generated plans directly in VS Code: answer embedded questions, annotate sections, and send structured feedback straight to Copilot chat.

What Problem Does It Solve?

Modern AI coding agents are great at one-shotting implementation — but getting to that point still takes iteration. Most of your time is spent collaborating with the agent on what to build: refining PLAN.md, SPEC.md, FIX.md, or ARCHITECTURE.md files, aligning on scope, and resolving open questions before a single line of code is written.

Plan Review is built for exactly that loop. It turns any .md file into a structured, interactive review surface right inside VS Code — so you can focus on the document, not the chat thread:

• AI agents can embed questions directly in the Markdown that you answer in context.
• Every section is clickable for inline annotations.
• When you're done, one click sends the full structured feedback back to Copilot chat — ready for the agent to pick up and get to work.

Screenshots

Main Review Surface

Open any .md file with Plan Review to see a clean, readable document with a live outline and a notes panel on the right.

Embedded AI Questions

AI-authored question blocks are rendered inline. Reviewers answer them without leaving the document.

Answering a Question

Type a response, hit Submit, and the question collapses into an answered state in the notes panel.

Inline Annotations

Click any paragraph, heading, list item, or code block to open the annotation sheet and leave a comment.

Annotation Markers

After submitting a comment, a dot marker appears on the block and the note appears in the right-hand panel.

Features

• Interactive document rendering — headings, paragraphs, lists, blockquotes, and syntax-highlighted code blocks, all clickable.
• Embedded AI questions — question:open, question:choice, and question:checkbox blocks rendered inline; answers tracked in state.
• Inline annotations — click any block to leave a comment; markers appear at the source block.
• General feedback — a persistent input at the bottom for overall plan comments.
• One-click feedback to Copilot — when you close the review panel or click Export, the full structured feedback is sent to Copilot chat automatically.
• Dark theme — high-contrast, reading-optimised layout that matches VS Code's default dark theme.
• Responsive layout — works from narrow split-editor panes to full-screen webview panels.

Getting Started

1. Install the extension from the VS Code Marketplace.
2. Open any .md file — Plan Review opens automatically as the default editor for Markdown files.
3. Read the plan, answer any embedded questions, and click sections to annotate.
4. Close the panel (or press the Export button) — structured feedback is sent to Copilot chat.

Tip: To switch between the standard Markdown preview and Plan Review for a file, right-click the file in Explorer → Open With… and choose your preferred editor.

Copilot Agent Skill

The extension ships with a built-in Agent Skill (markdown-plan-review-feedback) that Copilot and other AI agents can automatically discover and use. When the skill is active, the agent knows:

• The full Plan Review workflow — generate a structured .md file, the user reviews it, feedback flows back to the agent.
• The question:open, question:choice, and question:checkbox block syntax for embedding interactive questions.
• Best practices for structuring a reviewable document (headings, question placement, annotatable blocks).

This means you can simply ask Copilot to "draft a plan for X" and it will produce a question-rich Markdown file ready to open in Plan Review — no manual prompt engineering required.

Embedding Questions in a Plan

Questions are authored by AI agents as fenced code blocks with a question: language tag. Reviewers answer them directly in the review UI.

```question:open
id: q-approach
question: What do you think about this approach?
```

```question:choice
id: q-preference
question: Which option do you prefer?
options: Option A | Option B | Option C
```

```question:checkbox
id: q-features
question: Select all that apply
options: Feature 1 | Feature 2 | Feature 3
```

Choosing Which Editor Opens Markdown

Plan Review registers as the default custom editor for .md files. To switch back to the built-in Markdown preview or text editor for a specific file:

1. Right-click the file in Explorer → Open With…
2. Select the editor you want.
3. Optionally choose Set as Default to persist that preference for all .md files in the workspace.

License

MIT