Open
Conversation
Document that every repository task must start from main in a fresh git worktree so feature, refactor, and PR workflows do not inherit unrelated branch state. Constraint: User requested this as a standing rule for all future work. Confidence: high Scope-risk: narrow Directive: Start future implementation, refactor, and PR tasks from a new worktree based on main or origin/main. Tested: git diff --check Not-tested: make test/build not run because this is documentation-only.
![amazon-q-developer[bot]](https://avatars.githubusercontent.com/in/1220912?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
This PR successfully documents the worktree isolation workflow rule across agent skills and contributor documentation. The changes are consistent, properly formatted, and add clear guidance without introducing defects. No blocking issues identified.
You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.
nathanhuh
approved these changes
Apr 27, 2026
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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
Document the standing repository rule that all work starts from
mainin a fresh git worktree.AGENTS.mdfor agent-facing guidancedocs/development.mdRelated Issues
No issue. User requested this repository workflow rule directly.
Validation
env -u GOROOT make testenv -u GOROOT make buildgit diff --checkChecklist
docs/branch-naming-harness.mddocs/documentation-harness.md)docs/pages updated if workflow changedNo breaking changes.