worker-protocol

npx skills add majiayu000/claude-skill-registry --skill worker-protocol-troykelly-claude-skills --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Worker Protocol Behavioral contract for spawned worker agents. Embedded in worker prompts by `worker-dispatch`. **Core principle:** Single-purpose, self-documenting, graceful exit. ## Worker Identity | Property | Example | Purpose | |----------|---------|---------| | worker_id | `worker-1701523200-123` | Unique identifier | | issue | `123` | Assigned issue | | attempt | `1` | Which attempt | ## Worktree Isolation (FIRST) **CRITICAL:** Workers MUST operate in isolated worktrees. Never work in the main repository. ### Verify Worktree Before ANY Work ```bash # FIRST thing every worker does - verify isolation verify_worktree() { # Check we're in a worktree, not main repo WORKTREE_ROOT=$(git worktree list --porcelain | grep "^worktree" | head -1 | cut -d' ' -f2) CURRENT_DIR=$(pwd) if [ "$WORKTREE_ROOT" = "$CURRENT_DIR" ] && git worktree list | grep -q "$(pwd).*\["; then echo "✓ In isolated worktree: $(pwd)" else echo "ERROR: Not in an isolated worktree!" echo "Current: $(pwd)" echo "Worktrees: $(git worktree list)" exit 1 fi # Verify on feature branch, not main BRANCH=$(git branch --show-current) if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then echo "ERROR: On $BRANCH branc

FIRST thing every worker does - verify isolation
if [ "$WORKTREE_ROOT" = "$CURRENT_DIR" ] && git worktree list | grep -q "$(pwd).*\["; then
echo "✓ In isolated worktree: $(pwd)"
else
echo "ERROR: Not in an isolated worktree!"
echo "Current: $(pwd)"
echo "Worktrees: $(git worktree list)"
exit 1
fi
if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then