preview-epic-stacked

To preview stacked PRs locally, create a throwaway local preview branch that synthesizes the integrated state of open PRs, enabling safe verification of an epic flow without pushing. It discovers the PR stack from root to leaf and attempts an octopus merge with a sequential fallback on conflicts.

A stacked PR workflow for epic branches involves an epic spanning multiple interdependent PRs across a base branch. This approach discovers and orders the PR stack from root to leaf based on base/head relationships to validate the integrated state before merging to the mainline.

To resolve merge conflicts when previewing an epic locally, the process attempts an octopus merge for full integration and falls back to sequential merges on conflicts. It reports the specific conflicted PR, allowing you to address integration issues before pushing.

Yes, you can configure verification steps for a local preview branch using the .squadkit/config.json file. This configuration allows you to define specific validation checks to run after the preview branch is created and the PR stack is merged.

No external dependencies are required to run a local preview of an epic stack. The process relies on standard git merge mechanisms, dispatcher argument parsing, and local configuration via .squadkit/config.json to fetch refs and prepare the throwaway branch.

The best way to verify multiple interdependent open PRs before merging is to generate a throwaway local preview branch that fetches necessary refs and applies an octopus merge. This enables safe verification of the integrated epic state without pushing to the mainline.