px-implement

What problem does it solve?

Bridges the gap between a written implementation plan and production code by enforcing a disciplined, incremental process that prevents guesswork, preserves reviewability, and ensures acceptance criteria are verified.

Core Features & Use Cases

• Plan-driven implementation: Load a plan marked ready, follow its ordered steps, and update plan status to in-progress.
• Branch and Git discipline: Prompt the user for branching strategy, make incremental, reviewable commits, and follow repository conventions.
• Validation and handoff: Run appropriate tests or checks after each step, verify acceptance criteria, and instruct the user to run automated reviewers in a fresh thread.
• Use Case: Convert a researched and approved feature plan into a sequence of commits on a feature branch, with tests passing and clear handoff to reviewers.

Quick Start

Run px-implement and provide the path to a ready plan file, for example .ai-workflow/plans/20260222-offline-first-sync-phase-1.md, then follow prompts to select a branch and implement each step.