Repository navigation
Prefer worktree targets and create boards before their checkouts - #1430
Merged
Merged
Conversation
Agents are told to review the checkout they work in with a worktree target, which creates no checkout of its own, and to use commit targets only for fixed commits no checkout sits on. A board can start as a project target and move to the worktree with session_set_target once it exists. Agent-Session: f949acce-5c96-46f0-92af-57fc57a137fd Agent-Session: 8625c3c9-675e-4237-9d72-b6ea7df04976 Agent-Session: fca2688e-ace4-4fe3-9f94-49feab058dca Agent-Session: 778ba399-e5fb-4c16-a31b-3c8632db2fcd Agent-Session: fea01a6a-bba5-4058-b6c6-dbaccc15cd9c Agent-Session: 5625cb14-3381-4fef-8d68-2cdc27ef7155 Agent-Session: bf2987d8-e033-4e2b-9027-66a552fc7799 Agent-Session: 4e9794ef-5a99-4635-ae45-1af0c43d14da Agent-Session: bbe68e6e-ff83-4042-93bf-6f0b489709f8
thesiti92
force-pushed
the
docs/worktree-first-instructions
branch
from
October 27, 2026 18:31
d3b705a to
0ae070b
Compare
sidkmenon
approved these changes
Oct 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
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.
Why
Each pinned checkout of a large monorepo is expensive. A worktree target reviews the agent's own checkout and creates none, so the authoring instructions should steer agents there.
What
One bullet in
packages/review/instructions/authoring.md:worktreetarget for a change that lives in a checkout the agent has;commitsonly for fixed commits no checkout sits on (lower stack layers).project, thensession_set_targetto the worktree.set_targetalready moves boards across repositories.No code changes.