worktree

原文涵盖的主题

• Worktree
• Standard location: .worktrees/
• Script path
• Repo-declared worktree task
• Laravel Herd auto-handoff
• Workflow
• Step 1 - Repo info
• Step 1b - Scope check (open PRs)

Spin up an isolated git worktree so a new feature, bugfix, or parallel agent run lives on its own branch and its own filesystem path - without disturbing your main checkout. Each worktree arrives ready to run: env templates copied (never secrets), a private port block assigned, install commands detected. By default the agent session moves into the new worktree so subsequent work happens there - pass --no-enter to stay put. Pairs naturally with vd:cook and vd:fix (implement in the worktree) and vd:ship (land it). All worktrees live at /.worktrees/ - / - one rule for every repo type: standalone → /.worktrees/, monorepo → /.worktrees/, submodule → topmost superproject's .worktrees/. .worktrees/ is a top-level sibling of the .workbench/ artifact umbrella, deliberately not nested under it (full checkouts would pollute artifact globs and bloat the umbrella). The script auto-appends /.worktrees/ and .env.worktree to .git/info/exclude when not already ignored, so git status stays clean. Worktrees + the umbrella (artifacts survive worktree removal). Artifact paths anchor to the main worktree, so work done from any linked worktree writes back to the main checkout's .workbench/. Under paths.l

这里只展示节选，请以完整原文和当前要求为准。