studio

GitHub auth: !gh auth status >/dev/null 2>&1 && echo "Authenticated" || echo "Not authenticated"

Repository: !gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "Unknown"

Existing worktrees: !git worktree list --porcelain 2>/dev/null | grep -c "^worktree" || echo "0"

Studio state: !test -f .spec-flow/studio/state.yaml && echo "Active" || echo "Not initialized"

Roadmap status (next): !gh issue list --label "status:next,type:feature" --json number --jq 'length' 2>/dev/null || echo "0"

Roadmap status (backlog): !gh issue list --label "status:backlog,type:feature" --json number --jq 'length' 2>/dev/null || echo "0"

Commands:

• init N - Create N persistent worktrees (1-10) for parallel development
• setup - Configure GitHub branch protection for auto-merge CI flow
• status - Show all agent worktrees and their current work
• stop - Guidance for graceful shutdown

Target workflow:

/studio setup         → Configure GitHub for auto-merge
/studio init 3        → Create 3 agent worktrees
(open terminals, cd into each, run claude)
Each agent: /feature next → work → /ship-staging → /finalize → repeat

Prerequisites:

• Git repository with remote
• GitHub CLI authenticated
• Worktree manager script available

Step 0: Parse Command

Extract subcommand from $ARGUMENTS:

• init N → Create N worktrees
• setup → Configure GitHub branch protection
• status → Show studio status
• stop → Shutdown guidance

If no arguments or help requested, display usage and exit.

---

Command: init N

1.1 Validate Prerequisites

# Check git repo
if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
  echo "Error: Not inside a git repository"
  exit 1
fi

# Check GitHub auth
if ! gh auth status >/dev/null 2>&1; then
  echo "Error: GitHub CLI not authenticated. Run: gh auth login"
  exit 1
fi