docs(execute): add tier selection and isolation parameter info#190
docs(execute): add tier selection and isolation parameter info#190maystudios merged 1 commit intomainfrom
Conversation
…2 parallelism spec Documents Tier 1 worktree isolation defaults, Tier 2 deep competition strategy opt-in, and graceful degradation fallback in the execute command's process steps. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Documentation-focused update clarifying parallel execution tiers (Tier 1 worktree isolation vs Tier 2 Agent Teams) in the /maxsim:execute command docs, plus routine build-script-updated version artifacts.
Changes:
- Expanded
/maxsim:executedocs to mention Tier 1 defaults (isolation: "worktree",run_in_background: true) and Tier 2 opt-in (competition_strategy: deep, Agent Teams env var). - Updated CLI README command list and adjusted Planner role description to reflect GitHub-first plan comments.
- Bumped version artifacts to
5.13.1(config template +VERSIONconstant).
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| templates/templates/config.json | Template config version artifact updated to 5.13.1. |
| templates/commands/maxsim/execute.md | Adds Tier selection + isolation/background execution notes to execute command docs. |
| packages/cli/src/core/version.ts | Updates injected VERSION constant to 5.13.1. |
| packages/cli/README.md | Adds loop commands to command table; updates Planner description to match GitHub comment-based plans. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - Tier 1 (default): each Agent uses `isolation: "worktree"` and `run_in_background: true` | ||
| - Tier 2 (opt-in, `competition_strategy: deep`): Agent Teams with `SendMessage` debate — requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | ||
| - Graceful degradation: if Tier 2 is unavailable, falls back to Tier 1 automatically |
There was a problem hiding this comment.
The Tier 2 bullets here read like they apply to the general “execute parallel agents within each wave” flow, but in templates/workflows/execute.md Tier selection is described only under the Competitive Implementation (Optional) section (gated by config.execution.competitive_enabled and a critical label). Consider clarifying that Tier 2 (competition_strategy: deep + Agent Teams) is used for competitive/debate mode only, while standard wave execution remains Tier 1 worktree-isolated Agent subagents.
| - Tier 1 (default): each Agent uses `isolation: "worktree"` and `run_in_background: true` | |
| - Tier 2 (opt-in, `competition_strategy: deep`): Agent Teams with `SendMessage` debate — requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | |
| - Graceful degradation: if Tier 2 is unavailable, falls back to Tier 1 automatically | |
| - Tier 1 (standard/default): each wave is executed by `Agent` subagents using `isolation: "worktree"` and `run_in_background: true` | |
| - Tier 2 (competitive/debate mode only; opt-in via `competition_strategy: deep`): Agent Teams with `SendMessage` debate — used only when competitive execution is enabled and a `critical` task is being run, as described in @.claude/maxsim/workflows/execute.md; requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | |
| - Graceful degradation (competitive path only): if Tier 2 competitive execution is requested but unavailable, fall back to Tier 1 automatically for that work |
|
🎉 This PR is included in version 5.14.0 🎉 The release is available on: Your semantic-release bot 📦🚀 |
Summary
templates/commands/maxsim/execute.mddocumenting Tier 1 worktree isolation defaults, Tier 2 deep competition strategy opt-in, and graceful degradation fallbackisolation: "worktree",run_in_background: true,competition_strategy: deep, andCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1requirementsTest plan
npx vitest run— 548 tests pass (18 test files)npm run build— TypeScript compiles and assets copy cleanlynpm run lint— Biome passes (no errors; pre-existing warnings/infos in unrelated files)🤖 Generated with Claude Code