Enhance ai_update_pr command with mandatory repository state inspection #31607
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This stack of pull requests is managed by Graphite. Learn more about stacking. |
514c480 to
47e733f
Compare
This was referenced Aug 7, 2025
47e733f to
1da2df9
Compare
This was referenced Aug 7, 2025
1da2df9 to
bba4857
Compare
OwenKephart
approved these changes
Aug 7, 2025
Add Step 0 to always inspect repository state first, preventing incorrect assumptions about current branch or stack position based on stale context.
Add comprehensive workflow improvements including mandatory Step 0 for repository state inspection, detailed branch identification guidance with examples, and commit message updating functionality. This prevents errors from stale context and ensures accurate PR updates.
bba4857 to
d5147ed
Compare
This was referenced Aug 7, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary & Motivation
Enhance the ai_update_pr command documentation with comprehensive workflow improvements to prevent common errors and ensure accurate PR updates.
The key improvement is adding a mandatory Step 0 that requires inspecting the actual repository state before proceeding. This prevents the command from making incorrect assumptions based on stale context or previous conversation history.
Key changes:
git branch --show-current,gt ls -s, andgit statusThe updated documentation includes concrete examples showing how to read
gt ls -soutput correctly and emphasizes that the previous branch is the one immediately AFTER the current branch (marked with ◉) in the stack listing.How I Tested These Changes
Manually verified the command workflow by following the new Step 0 instructions and confirming accurate branch identification and diff generation.