orca-frontend
Installation
SKILL.md
Orca Frontend
Layer: Practice
Orcaは、並列worktreeの一覧、agent terminal、diff review、mobileからの通知と操作を一つの画面にまとめるfrontendとして使える。ただし、projectの正しさはOrcaに依存させない。Orcaを閉じても、別のmachineでOrcaがなくても、Worktrunkかplain gitで同じ状態を作れることを保つ。
worktreeのlifecycleの正本は worktree-workflow である。このSkillは、その上にOrcaを載せる時の扱いだけを書く。
Orcaに持たせないもの
- worktreeのsetup / teardown:処理は
worktree-workflowのrepository-controlledな入口に置き、orca.yamlからはそれを呼ぶだけにする。 - 作業の正本:Issue、branch、PRがcanonical stateである。Orcaのworkspace名、親子関係、sidebarの状態はUIの状態として扱う。
- orchestrationの状態:Orcaの Run / Task / Dispatch / 完了通知はtelemetryとして扱う。taskの完了やresultの採否は、GitHub IssueとPR、検証結果で判断する(
parallel-orchestration)。 - 共有されるmutable state:
worktree.sharedDirectoriesはsymlinkで同一directoryを共有するため、並行して書き込むbuild outputやnode_modulesには使わない。ユーザー設定のWorktree Shared PathsはmacOSでAPFS clone-copy(非対応環境ではsymlink)となる場合があり、複製後の変更は自動同期されない。方式を混同せず、mutable stateのworktree別ownershipと各worktreeでの検証を維持する(Mutable Ownership Safety)。
設定
orca.yaml は worktree-workflow と同じ入口を呼ぶ。setupAgentStartupPolicy: wait-for-setup にして、setupが終わる前にagentを起動させない。