apr

The APR (Automated Plan Reviser) is a specialized engineering workflow tool designed to manage the iterative refinement of the Flywheel Connector Protocol (FCP) specification. It acts as an autonomous agent interface that bridges technical documentation with GPT Pro 5.2 Extended Reasoning capabilities. By managing the full feedback loop, it ensures that high-level protocol definitions remain synchronized with Rust implementation guides and project READMEs, preventing architectural drift as the protocol evolves. It is primarily intended for lead architects and developers working on the Flywheel Connector ecosystem who require consistent, version-controlled documentation updates driven by AI-powered critique. The workflow handles everything from Oracle-based remote browser automation to logical commit grouping and documentation harmonization. Key features include full support for iterative revision rounds, automated inclusion of implementation details on a configurable interval, and robust history tracking for comparison between revision rounds. Users can trigger status checks, compare diffs across iterations, and run continuous improvement loops that parse GPT feedback into concrete actionable todo lists. When running the APR workflow, ensure you are in the project root directory. The system relies on .apr configuration files to map documents like FCP_Specification_V2.md and connector-specific guides. Practical usage involves running commands such as 'apr run <N>' for standard spec reviews or 'keep running apr rounds' for continuous refinement sessions. It is important to note that document contents are sent inline to ensure high-reliability performance without the common failure modes of file attachment systems. Ensure that Oracle server connectivity is correctly configured for your environment, using port 9333 to avoid conflicts, and utilize the provided diagnostic commands to monitor session stats and revision convergence across the protocol development lifecycle.