What is a Claude Code subagent?

A subagent is a specialized, independent instance of Claude Code launched by a parent agent to execute a specific, well-defined task in an isolated environment with its own context window.

Does the subagent track token usage?

Yes, the skill includes mandatory token measurement logic that tracks cumulative usage across the subagent session and reports it back to the parent agent via .completion.json.

How does this skill manage subagent output?

Subagents run unsupervised; all instructions provided by the main agent must be mechanical and include fail-fast conditions to report status back to the parent agent upon completion or blockage.

Can subagents make architectural decisions?

No, the skill enforces a 'Zero Decision Delegation' policy. All architectural choices and ambiguities must be resolved by the main agent before the subagent is spawned.

Why are git worktrees used for subagents?

Git worktrees provide an isolated filesystem environment, allowing subagents to modify code and run tests without interfering with the parent agent's current workspace or file state.

Subagent Spawner

Name: Subagent Spawner
Author: cowwoc

bycowwoc

•

生産性とワークフロー

Orchestrates autonomous Claude Code subagents in isolated git worktrees for concurrent, mechanical task execution.

概要

The spawn-subagent skill enables complex task delegation by launching independent Claude Code instances in isolated git worktrees. This allows a parent agent to maintain high-level coordination while subagents handle specific, well-defined implementation or planning tasks. It features robust token tracking, fail-fast mechanics, and strict state management to ensure subagents operate reliably without real-time user supervision. By isolating execution, it prevents context window bloat and allows for parallel development workflows.

主な機能

Strict token tracking and measurement across subagent sessions
Two-stage planning subagents for maximum token efficiency
Isolated Git worktrees for concurrent and sandboxed task execution
Mandatory fail-fast conditions to prevent autonomous error loops
Automatic project hook inheritance for consistent rule enforcement
2 GitHub stars

ユースケース

Offloading time-intensive implementation tasks to subagents while the main agent handles coordination
Performing routine code updates and refactors in a sandboxed environment to preserve main context
Executing multi-stage planning where subagents generate and refine detailed technical specs

概要

主な機能

Strict token tracking and measurement across subagent sessions
Two-stage planning subagents for maximum token efficiency
Isolated Git worktrees for concurrent and sandboxed task execution
Mandatory fail-fast conditions to prevent autonomous error loops
Automatic project hook inheritance for consistent rule enforcement
2 GitHub stars

ユースケース

Offloading time-intensive implementation tasks to subagents while the main agent handles coordination
Performing routine code updates and refactors in a sandboxed environment to preserve main context
Executing multi-stage planning where subagents generate and refine detailed technical specs