worktree

Worktree

开始任何非 trivial 的功能开发前，必须拉 worktree 隔离，不要直接在 main 上改代码。Skill / MCP description 如果改到 API route、localhost、script、CLI command、第一方执行面，即使只有几行，也不按“纯文档免验证”处理：默认跑 skill reference/surface 与 claim 对应的定向检查；只有共享契约、门禁执行链或 targeted 无法覆盖跨包合流风险时才跑 full pnpm gate；高风险标签单独加强对应独立审查 / 授权。非 trivial 行为改动仍应开 worktree。

获准的新 Feature 开工或旧 Phase 续做，在原责任现场先按 custody-recognition 核 accepted scope 并复用原 Task；worktree 只是代码隔离，不是新的托付身份。已批准的执行子线程继续自己的实现，不读取或迁移父线程 Task。

Co-Creation Docs 边界

纯文档不再按行数决定是否进 worktree。用户授权落盘的共创文档先加载 co-creation-docs；显然低风险时猫可直接判定，拿不准或准备升到重载体时才运行 pnpm classify:co-creation-docs：

• 显然 low-risk 或 delivery=direct_push → 不加载本 skill；走轻量文档校验 + 按内容决定 review=required|reuse|skip + commit/push。
• delivery=pull_request 且 lane=co_creation_docs → 独立分支用于冲突/治理 review，但不自动升级 full gate。
• lane=regular_development → 正常加载本 skill。

cat-cafe-skills/**、sop-definitions/**、脚本、CLI 与其他第一方执行面始终属于 regular development；文件扩展名是 .md 也不例外。

开工前 Recall（F102 记忆系统）🔴

拉 worktree 前，先用记忆系统搜一下相关上下文（见 CLAUDE.md 记忆系统段落）：

search_evidence("{feature关键词}")
search_evidence("{topic}", scope="all")

不搜就开工 = 从零开始，可能重蹈覆辙。

目录位置（铁律）

Clowder AI 项目：../cat-cafe-{feature-name}（relay-station/ 同级）

pnpm worktree:new ../cat-cafe-{feature-name} --branch feat/{feature-name} --owner {你的 catId} --policy merged

• 🔴 禁止在项目内部创建（不要用 .worktrees/ 子目录）
• 🔴 cat-cafe-runtime 是生产环境，绝对不能删/清理！ 它不是开发 worktree
• 🔴 禁止在 cat-cafe-runtime 里执行 pnpm start / pnpm runtime:start（会先 kill 旧 API，等于把在线 runtime 踢掉）
• 🔴 localhost:3003/3004 默认属于 cat-cafe-runtime。如果你要验证当前 worktree 的未合入改动，浏览器 / Playwright / curl 不能直接打这两个端口，除非你明确是在做 runtime 验收而不是开发验证

其他项目：先查 CLAUDE.md / AGENTS.md 有没有指定位置 → 有就用 → 没有再问用户。

创建前：Main 同步检查（F073 门禁）

开 worktree 前必须确认 main 与 origin/main 完全同步（双向）。其他猫看的是 origin/main，不同步 = 信息不对称。

# Step 1: 检查是否有未提交的文档变更
git status --porcelain docs/ | head -5
# 如果有输出 → 先 commit 再继续

# Step 2: 检查 main 与 remote 双向同步
git fetch origin main --quiet
AHEAD=$(git rev-list --count origin/main..main)
BEHIND=$(git rev-list --count main..origin/main)
echo "ahead=$AHEAD behind=$BEHIND"
# ahead > 0 → 先 git push origin main
# behind > 0 → 先 git pull origin main
# 两者都 = 0 → 可以继续