schalkneethling/refined-plan-mode

Dernière activité source enregistrée: 20 mai 2026 à 17:57

Catalogue SkillsMP mis à jour: 12 novembre 2026 à 12:52

skills collectés: 1

Étoiles GitHub: 3
Forks GitHub: 0

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/schalkneethling/refined-plan-mode.

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

# Refined Plan Mode Refined Plan Mode is a local web app for reviewing AI coding-agent plans with a pull-request-style feedback loop. Instead of reviewing a long plan in a terminal and replying with one unanchored message, you can open the plan in a browser, leave comments on specific lines, ranges, or selected text, and submit the feedback as structured JSON for the agent to consume. https://github.com/user-attachments/assets/0a351cd8-94b2-44d7-9f5f-78aeb43a5314 ## Current Status This is an MVP built for local use. The core review loop works: - read a versioned Markdown plan from `.plan-review/plans/` - view the plan as Markdown source in CodeMirror - add line, range, and text-selection comments - persist draft comments across reloads - submit feedback as JSON - approve a plan and copy it to `.plan-review/approved-plan.md` ## Quick Start Refined Plan Mode has two pieces: - a browser app in this repository for reviewing plan files - Codex and Claude Code plugins that keep the plan review loop consistent Install the plugin for your coding-agent harness. Then run this browser app against the target workspace's `.plan-review` directory. ### 1. Install the plugin #### Claude Code Claude Code can install Refined Plan Mode directly from this GitHub repository because it includes a root marketplace at: ```text .claude-plugin/marketplace.json ``` From Claude Code, add the marketplace and install the plugin: ```text /plugin marketplace add schalkneethling/refined-plan-mode /plugin install refined-plan-mode@refined-plan-mode ``` Or use the Claude Code CLI: ```sh claude plugin marketplace add schalkneethling/refined-plan-mode claude plugin install refined-plan-mode@refined-plan-mode ``` If you are developing locally from a clone, you can also add the repo-local marketplace: ```sh claude plugin marketplace add ./plugins/claude-code claude plugin install refined-plan-mode@refined-plan-mode ``` Both marketplaces point at the same Claude Code plugin package: ```text plugins/claude-code/refined-plan-mode ``` #### Codex This repository includes a repo-local Codex marketplace at: ```text .agents/plugins/marketplace.json ``` It points at the local plugin package: ```text plugins/codex/refined-plan-mode ``` If you open this repository in Codex, the `refined-plan-mode` plugin should be available from the repo-local marketplace. To use the plugin without opening this repository in Codex: 1. Clone or download this repository. 2. Copy or symlink `plugins/codex/refined-plan-mode` into a local plugin directory such as `~/plugins/refined-plan-mode`. 3. Add a home-local Codex marketplace entry in `~/.agents/plugins/marketplace.json` that points at `./plugins/refined-plan-mode`. Example home-local Codex marketplace: ```json { "name": "local", "interface": { "displayName": "Local Plugins" }, "plugins": [ { "name": "refined-plan-mode", "source": { "source": "local", "path": "./plugins/refined-plan-mode" }, "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, "category": "Productivity" } ] } ``` After that, install or enable `refined-plan-mode` from Codex's plugin UI. ### 2. Use natural prompts In the target project, ask your agent to use Refined Plan Mode: ```text Use Refined Plan Mode to plan this change. ``` After submitting feedback in the browser: ```text I submitted feedback in Refined Plan Mode. Continue. ``` After approving the plan: ```text The plan is approved. Continue with Refined Plan Mode. ``` The plugin skill inspects `.plan-review` and chooses the next state transition: - no current plan: write `.plan-review/plans/plan-v1.md`, write `.plan-review/.current-version`, and wait for review - feedback for the current version: write the next plan version, update `.current-version`, and wait for review - current plan without feedback or approval: remind you that the plan is awaiting review - approved plan: read `.plan-review/approved-plan.md` and execute it When a plan is ready for review, the agent should also print the reviewer launch command with `PLAN_REVIEW_DIR` pointing at the target project's `.plan-review` directory: ```sh PLAN_REVIEW_DIR=/absolute/path/to/project/.plan-review vp dev --host 127.0.0.1 --port 5173 ``` ### 3. Run the browser reviewer From this repository, install dependencies and start the app: ```sh vp install PLAN_REVIEW_DIR=/absolute/path/to/project/.plan-review vp dev --host 127.0.0.1 --port 5173 ``` Open: ```text http://127.0.0.1:5173/ ``` Review the current plan in the browser. You can leave comments on lines, ranges, or selected text, then submit feedback. The app writes feedback for the current version to: ```text .plan-review/feedback/plan-v1-feedback.json ``` Approving a plan writes: ```text .plan-review/approved-plan.md ``` ### 4. Continue the loop The core loop is: ```text Ask the agent to use Refined Plan Mode for a task Review in browser Submit feedback or approve Ask the agent to continue with Refined Plan Mode ``` Repeat review and feedback until the plan is approved. Once approved, ask the agent to continue with Refined Plan Mode so it can execute the approved plan. ## Legacy Commands The plugin workflow above is the recommended path. The slash-command prompts remain in this repository as a compatibility layer for agents or local setups that still prefer explicit commands. Use these commands in the target project: - `/rpm:start` starts a plan review loop for the user's current task. - `/rpm:feedback` reads feedback for the current plan version, writes the next plan version, and advances `.plan-review/.current-version`. - `/rpm:review` asks the agent to audit the latest plan for quality before you review it. - `/rpm:advance` moves to the next state: execute an approved plan, incorporate feedback, wait for review, or start a new plan. - `/rpm:checkpoint` reports the current version, feedback status, approval status, and recommended next action. - `/rpm:handoff` creates a compact continuation summary for another agent or future session. - `/rpm:reset` empties the current `.plan-review` directory while keeping the directory itself. ## Manual Workflow In the project you want to review, ask the coding agent to write its plan to: ```text .plan-review/plans/plan-v1.md ``` and create: ```text .plan-review/.current-version ``` with this content: ```text v1 ``` Then start Refined Plan Mode from this repository: ```sh PLAN_REVIEW_DIR=/absolute/path/to/project/.plan-review vp dev --host 127.0.0.1 --port 5173 ``` Open: ```text http://127.0.0.1:5173/ ``` After submitting a review, feedback is written to: ```text .plan-review/feedback/plan-v1-feedback.json ``` Ask the coding agent to read that file, address every comment, write the next plan version, and update `.plan-review/.current-version`. Whenever the agent writes a plan version that is ready for review, it should also include the command to launch this reviewer against the target workspace: ```sh PLAN_REVIEW_DIR=/absolute/path/to/project/.plan-review vp dev --host 127.0.0.1 --port 5173 ``` ## Manual Agent Prompts These prompts are useful when you are not using the Codex or Claude Code plugin. For the first plan: ```text When you produce your plan, write the full plan as markdown to the following file: .plan-review/plans/plan-v1.md Also create .plan-review/.current-version containing: v1 Create the directories if they do not exist. Do not summarize or truncate the plan. Then, continue to present the plan to the user. ``` For a review loop: ```text I reviewed your plan. Read the feedback from: .plan-review/feedback/plan-v1-feedback.json Address every comment, then, before presenting the plan again for review, write the revised full plan to: .plan-review/plans/plan-v2.md Also update: .plan-review/.current-version to: v2 Do not summarize or truncate the plan. ``` ## Development Install dependencies: ```sh vp install ``` Run the development server: ```sh vp dev --host 127.0.0.1 --port 5173 ``` Validate changes: ```sh vp check vp build ``` `vp test` currently exits with "No test files found" because no tests have been added yet. ## File Convention ```text .plan-review/ .current-version plans/ plan-v1.md plan-v2.md feedback/ plan-v1-feedback.json plan-v2-feedback.json approved-plan.md ``` ## Notes The app binds through the Vite+ dev server during local development. A production CLI/server wrapper is not implemented yet.

Chargement du README du dépôt…

Skills dans ce dépôt

Spécialistes en gestion de projets

1 catégories métier · 100% classifié

skill

métier

description

mis à jour

refined-plan-mode

Spécialistes en gestion de projets

Use when the user wants a versioned plan-review loop with browser feedback before implementation.

Langue du texte source : anglais

2026-05-20

Affichage de 1 skills collectés sur 1.