APR: Automated Plan Reviser

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 LLM

plan.md

13 lines

1 # Auth Service Plan

3 ## Overview

4 Build a login and signup system.

Architecture ReviewToo vague -- needs concrete endpoints, methods, request/response shapes.

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

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%

Automated Checks

1 warn5 fail

API endpoints definedNo endpoints specified

Data models presentNo schema definitions

Auth strategy definedNo token strategy

Input validationNot addressed

Rate limitingNot mentioned

Error handlingOnly "basic" mentioned

terminal

$ apr run 1

Loading plan.md (13 lines)...

Running architecture review...

[FAIL] 5 critical issues found

[WARN] 1 concern flagged

Generating revision...

Convergence

28%

Essential Commands

Configure a workflow (plan file, output dir) once

Run revision round 1 against the configured workflow

Next round, bundling the implementation doc

Compare two round outputs

Write the Claude Code integration prompt to a file

Round analytics and convergence signals

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. Point APR at it once (interactive wizard: plan file, output dir)
apr setup
# 3. Run revision rounds until the diff between rounds gets small
apr run 1
apr run 2 --include-impl
apr diff 2 1
apr stats
# 4. Review the latest round's output
apr show 2
# 5. Feed back to Claude Code for implementation
apr integrate 2 --copy

# 1. Generate initial plan with Claude Code

# (Claude creates plan.md)

# 2. Point APR at it once (interactive wizard: plan file, output dir)

apr setup

# 3. Run revision rounds until the diff between rounds gets small

apr run 1

apr run 2 --include-impl

apr diff 2 1

apr stats

# 4. Review the latest round's output

apr show 2

# 5. Feed back to Claude Code for implementation

apr integrate 2 --copy

New to ACFS?

What Is APR?

AI-Powered

Markdown Support

Iterative

Fast

The Refinement Cycle

Essential Commands

Typical Workflow

Ready to level up?

What Is APR?

AI-Powered

Markdown Support

Iterative

Fast

The Refinement Cycle

Essential Commands

Typical Workflow