What problem does it solve?
Prevents incomplete or low-quality work from being committed by enforcing WIP checks, branch policies, artifact updates, test validation, secrets scanning, and explicit human approval before creating commits and pull requests.
Core Features & Use Cases
- WIP detection and blocking: Detects active work tracked by the framework and blocks commits until work is completed.
- Branch management: Ensures commits occur on feature branches and warns when on main/master to avoid accidental direct pushes.
- Durable artifact updates: Uses project scripts to update journal and status artifacts so commits are accompanied by outcome-focused project state.
- Quality gates: Runs test/validation checks, verifies staged files, scans for obvious secrets, and surfaces warnings or errors.
- Human-in-the-loop commit and PR creation: Always shows diffs for approval, stages specific files, creates PRs, bumps VERSION, and logs review tasks for follow-up.
- Use Case: Finalizing a completed feature—verify no active WIP, update STATUS and JOURNAL, run the validation script, show the diff to the developer, then commit and open a PR.
Quick Start
Commit and create a PR for the current feature branch by running the pre-commit checks, updating the journal and status, showing the diff to the human for approval, and then performing a staged commit and PR creation.
