pi-straw-boss 的運作方式

README 背後的完整行為。使用說明在各篇指南；這份參考則逐節寫出程式實際怎麼做，所以請在下面找到需要的那一節，其餘可以略過。

Straw Boss 是 pi 的擴充功能。它把在 Herdr 裡執行的 pi session 接成一張網，給它們一條指揮鏈，讓每個工作區有一座塔台來協調，並把整張網顯示在同一頁上。

flowchart TD
    boss["你"] --> head["主塔台<br/>每台電腦一座"]
    head -->|"tower_send"| tower["塔台<br/>每個工作區一座"]
    tower -->|"boss_open_main"| main["主智慧體<br/>每個分頁一個"]
    member["成員<br/>分頁裡其他的 pi"] -.->|"boss_promote"| main
    main -->|"subagent"| sub["子智慧體<br/>工作者、偵察、規劃、<br/>審查、監控者"]
    main -->|"call_tower"| tower
    tower -->|"boss_open_main"| train["火車<br/>一批合併車廂"]
    server["sb server<br/>每台電腦一個"] -.->|"運行"| tower
    server -.->|"運行"| head

實線箭頭都是工具裡的工具。虛線不是工具：成員靠升任成為主智慧體，塔台則由 sb server 運行。

位置

位置	它是什麼	怎麼來的
成員	已加入、但不是主智慧體的 pi	session 啟動時自己加入
主智慧體	每個分頁一個；規劃、派工，並詢問老闆	升任（boss_promote、第一次呼叫 subagent）、/boss，或由塔台開啟
子智慧體	pi-herdr-agents 的子層；它不加入，由啟動它的 session 代表	由主智慧體或成員啟動
塔台	每個工作區一座；分派工作、修補協調上的摩擦，絕不詢問老闆	智慧體開始互相碰撞時開啟
主塔台	老闆唯一的入口，每台電腦一座；把每項指示交給某個工作區的塔台	老闆第一次說話時由 sb server 建立
火車	把一批合併車廂送進基底分支的工作者	塔台為專案的整合員開啟

主智慧體、子智慧體與塔台 run 的種類

主智慧體的種類（頁面顯示種類的詞；GUI 把 standing 稱為「值守」）

種類	用途	怎麼設定
coordinator（協調者）	預設：拆分工作、規劃、派出子智慧體	預設，或 boss_duty
integrator（整合員）	專案的合併火車：接收車廂、組成火車	boss_duty，或名稱 integ <project>
standing（值守）	看顧一個系統或一台機器，沒有終點	boss_duty

子智慧體的種類（讀自 pi-herdr-agents 給它的角色名稱，子智慧體在第一個 turn 把它記進自己的 session 檔；其他角色維持一般子智慧體）

種類	角色名稱	用途	協調者派出它時
worker（工作者）	worker	做一件任務：修改、執行、建置	在待辦指名某個圖之前，會被 sb: plan first 拒絕
scout（偵察）	scout	調查並回報	不需要計畫就放行
planner（規劃）	planner	寫計畫或設計	不需要計畫就放行
reviewer（審查）	reviewer、visual-tester、adversarial-reviewer	審查變更或檢查 UI	不需要計畫就放行
watchdog（監控者）	watchdog	監看另一個 session 或 Herdr 狀態，只回報	和工作者一樣被拒絕

塔台 run的種類（喚醒塔台的東西；規則在[本機 run](#本機 run)、老闆對話與隊友 run）

執行	由什麼喚醒	它是什麼
事件 run	session 送來的事件，例如主智慧體的 call_tower 或完成的里程碑	常駐 pane 裡的一個全新 pi；以 tower_done 和交接筆記結束
老闆對話	老闆的話（頁面的輸入框、常駐 pane、/boss tower）	接續老闆上一個 session 的 run
隊友 run	隊友的裝置送來的 Straw Link 訊息	常駐 pane 旁邊的 pane 裡的一個全新 pi，以寄件者的信任等級執行

要看哪一節

想知道	看
誰會加入、誰會升任、塔台何時開啟	運作方式
塔台知道什麼、塔台怎麼彼此對話、主塔台做什麼	塔台的摘要、塔台之間的對話、主塔台
隊友的電腦與無人值守的盒子	Straw Link、Straw Link operate
工作看板與自動模式	工作看板、自動模式
開啟與關閉主智慧體、設定檢查	開啟主智慧體、設定檢查、關閉開啟的主智慧體
安全地合併很多分支	合併火車
儀表板，以及失去啟動者的子智慧體	塔台儀表板、孤立的子智慧體
瀏覽器頁面：地圖、通訊畫面、警示、手機、禪	瀏覽器檢視
Herdr 側邊欄、worktree 清理、行程清理	側邊欄網檢視、Worktree reaper、程序衛生與 slot
背景 server、塔台 run、常駐 pane、記憶、隊友 run	sb server
指令、它寫入的檔案、Windows、開發	工具、它寫入什麼、從 shell 使用、Windows、開發