squadrant 0.17.1 → 0.18.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "squadrant",
   "packageManager": "pnpm@10.30.3",
-  "version": "0.17.1",
+  "version": "0.18.0",
   "description": "Multi-project orchestration for your coding agents (Claude, Codex, opencode, Gemini)",
   "type": "module",
   "bin": {

package/plugin/skills/captain-ops/SKILL.md

@@ -194,7 +194,7 @@ To change the effort dial: `squadrant effort <max|balance|low>` or use the `squa
 - **Close crews you're done with** (`squadrant crew close ...`) so they don't accumulate.
 - Crews run in **isolated worktrees by default** (parallel-safe, branch per crew). Pass `--shared` only for tiny/one-off tasks that don't need branch isolation. Never hand-run `git worktree add` — `squadrant crew spawn` handles it.
 - Do NOT edit source code yourself — always delegate to crew.
-- Respect `maxCrew` — don't exceed the configured concurrent crew count.
+- Respect `maxCrew` — don't exceed the configured concurrent crew count. Held crews do not count toward the limit, and at the limit you must ask the operator rather than choosing a crew to close.
 - **For complex multi-step tasks** (3+ steps, multiple files), tell the crew to use GSD inside the task prompt: *"This is a complex task. Use `/gsd:plan-phase` and `/gsd:execute-phase` for wave-based execution with fresh context per step."*
 - **For simple tasks**, don't mention GSD — the crew will handle it directly.
 

package/plugin/skills/handback/SKILL.md

@@ -0,0 +1,8 @@
+# /handback
+
+Runs when the operator is finished driving this tab and wants to return control to the captain.
+
+1. First, you MUST run this command to clear the takeover in the control plane:
+   `squadrant crew handback --task-id "$SQUADRANT_CREW_TASK_ID"`
+
+2. Acknowledge to the user: you have returned control to the captain. You are no longer in operator mode, and the normal completion protocol (running `squadrant crew signal done` when finished) applies again.

package/plugin/skills/takeover/SKILL.md

@@ -0,0 +1,11 @@
+# /takeover
+
+Runs when the operator wants to take direct control of this crew tab.
+
+1. First, you MUST run this command to record the takeover in the control plane:
+   `squadrant crew takeover --task-id "$SQUADRANT_CREW_TASK_ID"`
+
+2. Acknowledge to the user: you now work directly for the operator, not the captain.
+   **Do not run `squadrant crew signal done`** when you finish what the operator asked — wait for `/handback`.
+
+You are now in operator mode.

package/templates/captain.claude.md

@@ -37,6 +37,7 @@ You are a **project captain** for Squadrant. You lead ONE project. You are a **c
    squadrant crew read <project> <name>          # read its screen
    squadrant crew close <project> <name>         # shutdown when done
    ```
+   **Operator Takeover:** A crew under operator takeover is off-limits — no `send`, no `close`, and its lifecycle signals are not yours to act on. If you are at your crew limit, **ask the operator**; never pick a held crew to close. `--force` exists only for when the operator explicitly tells you to use it.
 3. **Record learnings** when something unexpected happens or a pattern emerges (`squadrant:captain-ops` shows the script).
 4. **Compact recovery** — if you feel disoriented after `/compact`, re-read your handoff (`{spokeVault}/handoffs/`) to restore work context. Role itself survives compact via `--append-system-prompt-file`.
 

package/templates/captain.generic.md

@@ -16,6 +16,7 @@ You are a project captain coordinating work via cmux workspaces. You are a coord
    squadrant crew close <project> <name>         # shutdown when done
    squadrant crew list <project>                 # all live crews
    ```
+   **Operator Takeover:** A crew under operator takeover is off-limits — no `send`, no `close`, and its lifecycle signals are not yours to act on. If you are at your crew limit, **ask the operator**; never pick a held crew to close. `--force` exists only for when the operator explicitly tells you to use it.
 4. Communicate with the project's captain workspace via:
    ```bash
    squadrant runtime send <project> "<message>"