Skip to content

Route independent parallel work to built-in /batch, reserve /fleet for multi-wave#40

Merged
Jason-Adam merged 3 commits intomainfrom
route-independent-parallel-to-batch
Mar 30, 2026
Merged

Route independent parallel work to built-in /batch, reserve /fleet for multi-wave#40
Jason-Adam merged 3 commits intomainfrom
route-independent-parallel-to-batch

Conversation

@Jason-Adam
Copy link
Copy Markdown
Owner

Summary

  • Independent parallel work (disjoint file sets, no dependencies) now routes to Claude Code's built-in /batch command instead of /fleet
  • /fleet is reserved for its unique value: dependency-aware multi-wave execution with discovery brief compression between waves
  • Router keyword heuristics split: batch captures parallel/concurrent/independent; fleet captures worktree/wave/dependency
  • Fleet skill identity narrowed to "dependency-aware multi-wave coordinator" with guidance to redirect independent work to /batch

Motivation

The built-in /batch handles independent parallel work better:

  • 5-30 workers (vs fleet's max 3 per wave)
  • Automatic PR creation per unit
  • Built-in /simplify quality gates on every PR

Fleet's unique value is multi-wave orchestration where wave N's output informs wave N+1 via brief compression -- this is preserved.

Test plan

  • All 460 tests pass
  • Ruff, ruff format, mypy all pass (pre-commit hooks)
  • Keyword heuristic: "parallel concurrently" -> batch, "multi-wave worktree" -> fleet
  • Plan analysis: independent phases -> batch, sequential phases -> run (unchanged)
  • Loop mode: batch maps to run (batch is self-contained, doesn't need loop)
  • Explicit /fleet command still works (Tier 0 pattern match unchanged)

🤖 Generated with Claude Code

…r multi-wave

The built-in /batch command handles independent parallel work better (5-30
workers, auto-PR, /simplify gates). /fleet's value is dependency-aware
multi-wave execution with brief compression between waves.

- Tier 2.5: independent plan phases -> batch instead of fleet
- Tier 2: split keywords (batch=parallel/concurrent, fleet=worktree/wave)
- Loop mode: batch maps to run (batch is self-contained)
- Fleet skill: narrowed identity to dependency-aware coordinator
- /do skill: updated classification table and decision priority

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings March 30, 2026 16:07
@Jason-Adam Jason-Adam self-assigned this Mar 30, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the router and documentation to send independent parallel work to Claude Code’s built-in /batch, while reserving /fleet for dependency-aware, multi-wave orchestration.

Changes:

  • Route plan-detected independent phases to batch and map batchrun in loop mode.
  • Split Tier 2 keyword heuristics so “parallel/concurrent/independent” → batch, while “worktree/wave/dependency” → autodidact-fleet.
  • Update skill docs and tests to reflect the new batch vs fleet responsibilities.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
src/router.py Routes independent plan phases to batch, updates keyword scoring, and maps batch to run for loop mode.
tests/test_router.py Updates/expands tests to assert batch routing for parallel/independent work and loop-mode behavior.
skills/fleet/skill.md Repositions /fleet identity toward dependency-aware multi-wave execution and recommends /batch for independent work.
skills/do/skill.md Updates the orchestration matrix/priority and guidance to prefer built-in batch for independent parallel work.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Jason-Adam and others added 2 commits March 30, 2026 17:12
…nsistency

- Add `batch` to the exception list in the autodidact- prefix IMPORTANT note
- Update fleet frontmatter description, heading, and protocol wording to
  reflect dependency-aware positioning instead of generic "parallel"

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@Jason-Adam Jason-Adam merged commit 939db1d into main Mar 30, 2026
3 checks passed
@Jason-Adam Jason-Adam deleted the route-independent-parallel-to-batch branch March 30, 2026 16:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants