Skip to content

docs(AGENTS): make Claude finish always include via-pr + wait-for-merge + cleanup#404

Merged
NagyVikt merged 1 commit intomainfrom
agent/claude/default-claude-finish-auto-merge-cleanup-2026-04-23-21-49
Apr 23, 2026
Merged

docs(AGENTS): make Claude finish always include via-pr + wait-for-merge + cleanup#404
NagyVikt merged 1 commit intomainfrom
agent/claude/default-claude-finish-auto-merge-cleanup-2026-04-23-21-49

Conversation

@NagyVikt
Copy link
Copy Markdown
Collaborator

Automated by gx branch finish (PR flow).

…ge + cleanup

Previous contract already listed the four flags in prose but allowed the
reader to stop at bare `--via-pr`. This session demonstrated the failure
mode: a PR merged before a follow-up commit pushed, stranding the commit
on a local agent branch.

Changes:
- Switch the step-3 example's `--base dev` to `--base main` (this repo's
  default base) so the recipe runs verbatim.
- Add a "Default Claude finish (non-negotiable)" subsection that:
  - Requires all four flags unless the user opts out.
  - Shows the `gh pr merge <N> --auto --squash` follow-on for
    branch-protected repos.
  - Documents `GUARDEX_FINISH_MERGE_TIMEOUT` for slow CI.
  - Points to `gx finish --all` for sweeping multiple lanes.
  - Captures the `git worktree remove --force` recovery recipe when a
    source-probe temp worktree holds an agent branch.
@NagyVikt NagyVikt merged commit 613f792 into main Apr 23, 2026
@NagyVikt NagyVikt deleted the agent/claude/default-claude-finish-auto-merge-cleanup-2026-04-23-21-49 branch April 23, 2026 19:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant