autoresearch-finalize

What problem does it solve?

Finalize an autoresearch session by turning a noisy branch of experiments into a clean, reviewable set of independent branches starting from the merge-base, making it easy to review, merge, or discard individual ideas.

Core Features & Use Cases

• Group experiments into logical changesets from the merge-base with one idea per branch.
• Independent review: Each branch can be landed in any order without cross-branch file conflicts, simplifying code review and collaboration.
• Guardrails and verification: Preflight checks detect overlapping file changes, ensure last-kept commits exist, and verify that the union of created branches matches the original autoresearch work.
• Use Case: When an autoresearch session produces multiple logical experiments, quickly isolate each into its own branch to enable focused reviews and clean history.

Quick Start

Run the finalize.sh script with your groups.json to generate independent reviewable branches.