用途：当另一个智能体已在同一目录工作，或需要同时推进多个功能时，用 Git worktree 实现并行开发。每个 worktree 检出独立分支到单独目录，文件相互隔离但共享同一 Git 历史与远程连接，因此并行智能体不会互相干扰。
主要能力与约定：所有 worktree 必须创建在仓库根目录的 .letta/worktrees/ 下，保持整洁、被 gitignore 忽略且不进入用户项目目录。创建首个 worktree 前，先确保 .letta/worktrees 已加入 .gitignore： grep -q '.letta/worktrees' .gitignore 2>/dev/null || echo '.letta/worktrees' >> .gitignore
使用方式：在新 worktree 中运行任何命令前，先查看项目设置说明——README（通常含安装/构建命令）、claude.md 或 AGENT.md（智能体专用指引）、项目记忆块（已学习的项目偏好）。不要假定使用 npm、bun 还是 pnpm，须先确认。常用命令： git worktree add -b <branch> .letta/worktrees/<name> main git worktree add .letta/worktrees/<name> <existing-branch> git worktree list git worktree remove .letta/worktrees/<name>
适用场景：另一智能体正在当前目录工作；一个会话跑长任务、另一个会话需快速修复；用户希望在智能体开发独立功能时继续开发。
限制与注意：worktree 共享 .git，但 pre-commit 钩子可能需按项目设置初始化，安装依赖后、提交前应确认钩子已生效。命名应清晰，如 .letta/worktrees/feature-auth、.letta/worktrees/bugfix-123。移除 worktree 前先推送改动。若用户对 worktree 感到困惑或明确偏好克隆方式，可改用多次克隆仓库（gh repo clone owner/repo project-01），隔离更彻底但占用更多磁盘空间。