適用情境

想先看全景再逐課深入的人。這條線就是官方說的 “a clear plan, a separate place to work, and a visible trail of progress” 的具體展開。

核心步驟

1. 開專案——thinkrail ~/code/my-repo（或 app 內 Start a new project 建空 repo 在 ~/thinkrail）。專案＝一個 git repo（專案與工作區）。
2. 切工作區——⌘N 從 repo 切出一個 git worktree：自己的分支、自己的目錄。Default workspace（直接動 repo）是明確選擇才用。多件事就多個工作區平行跑。
3. 開對話，讓代理計畫——每個工作區可多個 pi session，各選各的模型。共用計畫代理更新、你編輯；需求不清楚時代理會用結構化提問問你（對話與 pi session）。
4. 逐輪審查——工作台看 diff、檔案樹的變更標記、釘審查註解送回對話當 context。審的是 turn，不是聊天記錄。
5. 出 PR——topbar 一鍵 publish/push/open PR（描述可來自計畫、commits、PR template 或代理草稿），CI checks 與 review 就在 topbar；失敗的 checks 交給代理修（出 PR 工作流）。
6. 合併收納——PR 合併（或關閉、或靜置一週）後工作區自動 settle 到 per-project shelf；你一回來它就回來。

與其他工作流的關係

• 第一次用？走第一個專案，10 分鐘版。
• 多件事同時開？看平行工作區。
• 已經是 pi 用戶？看帶著 pi 設定搬家。