How long can an agent team run before timing out?

The protocol sets a maximum team duration of 15 minutes from creation. If tasks are not finished, it triggers a structured shutdown and forces cleanup.

What happens if a parallel agent fails to complete its task?

If an agent cannot resolve an error after 3 attempts, it messages the lead rather than marking the task as complete. The lead then manages partial failure recovery or completes the work sequentially.

Is this used for planning or execution?

This protocol is specifically for the parallel execution phase of an issue. For multi-round deliberation and planning, the 'deliberation-protocol' skill is recommended instead.

How does the protocol prevent merge conflicts between agents?

The protocol enforces strict file ownership where each agent is assigned specific files and must use 'git pull --rebase' along with targeted 'git add' commands for their owned files only.

What is the Phase 0 Contract-First Handoff?

It is a preparation stage where the lead agent defines model shells, interfaces, and method signatures (types only) to ensure all parallel agents are building toward a compatible architecture.

Agent Team Protocol

Name: Agent Team Protocol
Author: Kiwi-Home

byKiwi-Home

0•

生产力与工作流

Orchestrates parallel AI agent teams for complex coding tasks using structured handoffs, file ownership, and TDD workflows.

The Agent Team Protocol is a specialized framework designed to manage multiple AI agents working in parallel on a single feature implementation. It enforces a rigorous lifecycle—from contract-first handoffs to integration and shutdown—ensuring that parallel execution remains coordinated and conflict-free. By defining strict file ownership, automated git rebase strategies, and layer-specific TDD loops, this skill allows Claude to act as a lead architect that delegates implementation tasks to sub-agents without compromising code quality or architectural integrity.

主要功能

01TDD-First Completion Loop: Mandates automated testing for every layer before task completion.

02Contract-First Handoff: Defines interface shells and types before execution to prevent architectural drift.

03Strict File Ownership: Assigns specific files to agents to prevent merge conflicts during parallel work.

04Automated Team Lifecycle: Manages the spawning, coordination, and sequential shutdown of agent teams.

050 GitHub stars

06Parallel Layer Execution: Supports simultaneous development of models, logic, and API layers.

使用场景

01Implementing multi-layered features where API, service, and database logic can be built simultaneously.

02Executing large-scale refactors across multiple independent modules within a repository.

03Accelerating issue resolution by distributing tasks across specialized sub-agents with automated cleanup.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kiwi-home/ai-coding-resources agent-team-protocol

For use in Claude.ai and ChatGPT

Download Skill