Goal
Master AI-powered plan revision with Automated Plan Reviser Pro.
What Is APR?
APR (Automated Plan Reviser Pro) automates iterative specification refinement using extended AI reasoning. Instead of manually running 15-20 review rounds, APR orchestrates the process automatically.
Early rounds fix architectural issues, middle rounds refine structure, later rounds polish abstractions. The process resembles numerical optimization settling into a minimum.
AI-Powered
Uses advanced LLMs to refine plans
Markdown Support
Works with your existing plan files
Iterative
Refine plans through multiple passes
Fast
Get improved plans in seconds
The Refinement Cycle
Watch how APR iteratively improves a specification through multiple passes. Each cycle tightens the quality until the plan converges on a polished result.
Pass 1: Initial Draft28%
Raw specification from LLMplan.md13 lines
1 # Auth Service Plan
2
3 ## Overview
4 Build a login and signup system.
Architecture ReviewToo vague -- needs concrete endpoints, methods, request/response shapes.
5
6 ## Features
7 - Add login
8 - Add signup
9 - Handle tokens
Security Audit"Handle tokens" is underspecified. Define token type, expiry, rotation strategy.
10 - Basic error handling
11
12 ## Database
13 - Store users somewhere
Architecture Review"Store users somewhere" needs a schema with fields and constraints.
Initial draft loaded. Major gaps in all categories.
Added Removed Modified Unchanged
Quality Progression28%
28
P1
P2
P3
P4
P5
P6
Automated Checks
1 warn5 fail
API endpoints defined
Data models present
Auth strategy defined
Input validation
Rate limiting
Error handling
terminal
$ apr refine plan.md --pass 1
Loading plan.md (13 lines)...
Running architecture review...
[FAIL] 5 critical issues found
[WARN] 1 concern flagged
Generating revision...
Convergence28%
Essential Commands
Refine a plan file
Save to specific file
Show all options
Pro Tip
Use APR after Claude Code generates an initial plan to get a more thorough version.
Typical Workflow
bash
# 1. Generate initial plan with Claude Code# (Claude creates plan.md)# 2. Refine with APRapr refine plan.md -o refined-plan.md# 3. Review the refined plancat refined-plan.md# 4. Feed back to Claude Code for implementation