Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ This is the most complex agent with multiple responsibilities:
### 3. Worker (`internal/templates/agent-templates/worker.md`)

**Role**: Execute specific tasks and create PRs
**Worktree**: Isolated branch (`work/<worker-name>`)
**Worktree**: Isolated branch (`multiclaude/<worker-name>`)
**Lifecycle**: Ephemeral (cleaned up after completion)

Workers are the "muscle" of the system. They:
Expand Down
2 changes: 1 addition & 1 deletion docs/COMMANDS.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Workers do the grunt work. Give them a task, they make a PR.
```bash
multiclaude worker create "task description" # Spawn a worker
multiclaude worker create "task" --branch feature # Start from a specific branch
multiclaude worker create "Fix tests" --branch origin/work/fox --push-to work/fox # Iterate on existing PR
multiclaude worker create "Fix tests" --branch origin/multiclaude/fox --push-to multiclaude/fox # Iterate on existing PR
multiclaude worker list # Who's working?
multiclaude worker rm <name> # Fire this one
```
Expand Down
4 changes: 2 additions & 2 deletions docs/CRASH_RECOVERY.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,7 +149,7 @@ git status # Check for uncommitted work
# Option 2: Save work and remove worker
cd ~/.multiclaude/wts/<repo>/<worker-name>
git stash # or: git add . && git commit -m "WIP"
git push -u origin work/<worker-name>
git push -u origin multiclaude/<worker-name>
multiclaude worker rm <worker-name>

# Option 3: Force remove (lose uncommitted work)
Expand Down Expand Up @@ -375,7 +375,7 @@ ls ~/.multiclaude/messages/<repo>/
# Compare with agents in state.json

# Orphaned branches
git -C ~/.multiclaude/repos/<repo> branch | grep work/
git -C ~/.multiclaude/repos/<repo> branch | grep multiclaude/
```

### Check Process Status
Expand Down
14 changes: 7 additions & 7 deletions docs/WORKFLOWS.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,10 +48,10 @@ You're in your workspace. You want stuff done. Spawn workers.
│ │ On it. ││
│ │ ││
│ │ > multiclaude worker create "Implement rich list commands per issue #44"││
│ │ ✓ Worker created: swift-eagle (branch: work/swift-eagle) ││
│ │ ✓ Worker created: swift-eagle (branch: multiclaude/swift-eagle) ││
│ │ ││
│ │ > multiclaude worker create "Improve error messages per issue #45" ││
│ │ ✓ Worker created: calm-deer (branch: work/calm-deer) ││
│ │ ✓ Worker created: calm-deer (branch: multiclaude/calm-deer) ││
│ │ ││
│ │ Two workers deployed. Check on them with: ││
│ │ multiclaude worker list ││
Expand Down Expand Up @@ -123,8 +123,8 @@ multiclaude agent attach merge-queue --read-only
│ │ [PR Check - 14:45] ││
│ │ ││
│ │ > gh pr list --author @me ││
│ │ #47 Add rich list commands work/swift-eagle ││
│ │ #48 Improve error messages work/calm-deer ││
│ │ #47 Add rich list commands multiclaude/swift-eagle ││
│ │ #48 Improve error messages multiclaude/calm-deer ││
│ │ ││
│ │ Checking #47... ││
│ │ > gh pr checks 47 ││
Expand All @@ -146,7 +146,7 @@ CI fails? Merge queue spawns a fixer:
│ │ ││
│ │ Spawning fixup worker... ││
│ │ > multiclaude worker create "Fix test failures in PR #48" \ ││
│ │ --branch work/calm-deer ││
│ │ --branch multiclaude/calm-deer ││
│ │ ✓ Worker created: quick-fox ││
│ │ ││
│ │ I'll check back after quick-fox pushes. ││
Expand All @@ -158,8 +158,8 @@ Got review comments? Spawn a worker to fix them:

```bash
multiclaude worker create "Fix review comments on PR #48" \
--branch origin/work/calm-deer \
--push-to work/calm-deer
--branch origin/multiclaude/calm-deer \
--push-to multiclaude/calm-deer
```

Worker pushes to the existing branch. Same PR. No mess.
Expand Down
2 changes: 1 addition & 1 deletion docs/extending/STATE_FILE_INTEGRATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ The daemon persists state to `~/.multiclaude/state.json` and writes it atomicall
{
"name": "clever-fox",
"task": "Add auth",
"branch": "work/clever-fox",
"branch": "multiclaude/clever-fox",
"pr_url": "https://github.com/user/my-app/pull/42",
"pr_number": 42,
"status": "merged",
Expand Down
2 changes: 1 addition & 1 deletion internal/templates/agent-templates/worker.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ multiclaude message send supervisor "Need help: [your question]"

## Branch

Your branch: `work/<your-name>`
Your branch: `multiclaude/<your-name>`
Push to it, create PR from it.

## Environment Hygiene
Expand Down