team-execute

Spawns a multi-agent team to implement an approved plan in isolated git worktrees.

3|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/ArangoGutierrez/claude-toolkit --skill team-execute-arangogutierrez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: team-execute
Source: https://github.com/ArangoGutierrez/claude-toolkit/tree/main/.claude/skills/team-execute
Command: npx skills add https://github.com/ArangoGutierrez/claude-toolkit --skill team-execute-arangogutierrez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multi-agent implementation work is error-prone: agents get spawned in the wrong order, PRs skip review, and work lands directly on shared branches. This Skill turns an approved plan into a disciplined team execution with enforced roles, gates, and review cycles. ## Core Features & Use Cases - Ordered agent spawning: Spawns a Principal Engineer, then a QA Engineer, then up to 3 Workers in a mandatory order, each with a defined model tier and dispatch contract. - Worktree isolation with hard gates: Creates one git worktree per task and refuses to run if the branch is more than 50 commits behind the default branch or no plan exists. - Gated PR workflow: Workers open draft PRs only; QA runs CI-equivalent checks and is the sole agent allowed to promote a PR to ready after Principal Engineer review. - Use Case: After running team-plan for a gpu-scheduler-retry project, invoke this Skill to spin up the team, have Workers implement tasks via TDD in separate worktrees, and get reviewed, validated draft PRs promoted only after the full review cycle passes. ## Quick Start Run /team-execute with the project name of an existing plan in .agents/plans/ to spawn the agent team and begin implementation.

Frequently Asked Questions about team-execute

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I spawn a multi-agent team to implement a plan in Claude Code?▼

Run /team-execute with the project name once a plan exists in .agents/plans/. It verifies you are on agents-workbench, creates one git worktree per task, and spawns a Principal Engineer, QA Engineer, and up to 3 Workers in that order.

What is the difference between team-plan and team-execute?▼

team-plan writes the implementation plan to .agents/plans/<project>.md, while team-execute consumes that plan and spawns the agent team to implement it. team-execute refuses to run if no plan exists, so team-plan must run first.

Why does team-execute refuse to run on my branch?▼

It refuses if you are not on agents-workbench, if no plan exists, or if the branch is more than 50 commits behind the default branch. Sync with git merge origin/<default> first to avoid conflict-heavy PRs.

Why did my spawned worker report BLOCKED with an empty diff?▼

That is the signature of an accidental background dispatch, where Write/Edit/Bash are auto-denied. Re-dispatch a fresh foreground agent instead of resuming a completed one.

Who is allowed to mark a draft PR as ready for review?▼

Only the QA Engineer may run gh pr ready, and only after its validation, the Principal Engineer review, and external feedback triage all pass. Workers are forbidden from promoting PRs and must always create drafts.

When should I not use team-execute?▼

Skip it for single-file fixes or work with no approved plan; use a TDD skill directly instead. It is designed for work spanning two or more source files or requiring design decisions that justify a full team.