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を起動させない。

Installs
6
GitHub Stars
2
First Seen
Oct 26, 2026