Soul-Brews-Studio/workon

/workon — Work + Resume

Start work from issue OR resume killed worktree.

Usage

/workon #435                              # Work on issue (this repo)
/workon #435 --oracle neo                 # Assign to specific Oracle
/workon Soul-Brews-Studio/repo#435        # Cross-repo issue
/workon --resume athena                   # Resume killed worktree + old session

Flow: Issue → Worktree → Work → PR

Step 1: Read Issue

gh issue view [N] --repo [owner/repo] --json title,body,labels,assignees

Step 2: Spawn Worktree

Create isolated worktree for the work:

git worktree add .claude/worktrees/<task-name> -b worktree-<task-name>

Or via EnterWorktree tool:

EnterWorktree({ name: "<task-name>" })

Step 3: Create Tracking Issue (if cross-repo)

If working on a different repo:

gh issue create --repo [target-repo] --title "[task]" --body "From [source-repo]#[N]"

Step 4: Work

The oracle works in the worktree on the issue. When done:

1. Commit changes
2. Create PR
3. Notify parent oracle

Step 5: Confirm

/workon #435

  Issue:     /awaken Wizard v2
  Worktree:  awaken-wizard-v2
  Branch:    worktree-awaken-wizard-v2
  
  Working in isolation. Main is untouched.

Mode 2: --resume — Restore Killed Worktree

Step 1: Find Old Session

for dir in ~/.claude/projects/*[name]*/; do
  ls -lS "$dir"*.jsonl 2>/dev/null
done

Pick largest .jsonl = most context.

Step 2: Recreate Worktree + Resume

git worktree add .claude/worktrees/<name> -b worktree-<name>
claude --resume [session-id]

Rules

• Always create gh issue before working (visibility)
• Feature branch + PR — never push to main directly
• Human approves merges — Oracle works autonomously otherwise
• Resume scans ~/.claude/projects/ not maw ls (sessions persist)

ARGUMENTS: $ARGUMENTS