---

name: worker-workflow description: Core task execution workflow for teamwork workers (Phase 1-5). Ensures workers properly claim, execute, and update task status.

Task Execution Workflow

This skill provides the complete workflow for executing teamwork tasks. Follow these phases in order.

Input Format

Your prompt includes:

CopyTEAMWORK_DIR: {path to teamwork directory}
PROJECT: {project name}
SUB_TEAM: {sub-team name}
SCRIPTS_PATH: {path to scripts directory}

Options:
- role_filter: {role} (optional)
- strict_mode: true|false

---

The value SCRIPTS_PATH: /path/to/scripts in your prompt is text. When writing bash commands:

WRONG (will fail):

Copybun "$SCRIPTS_PATH/task-list.js"  # Shell cannot expand $SCRIPTS_PATH

CORRECT (substitute the actual value):

Copybun "/path/to/scripts/task-list.js"  # Use the value from your prompt directly

Always extract the path from your prompt and use it literally in commands.

---

Phase 1: Find Task

List available tasks (open, unblocked, unclaimed):

Copybun "$SCRIPTS_PATH/task-list.js" --project {PROJECT} --team {SUB_TEAM} --available --format json

Or filter by your role:

Copybun "$SCRIPTS_PATH/task-list.js" --project {PROJECT} --team {SUB_TEAM} --available --role {role_filter}

If no task found: Report "No available tasks" and exit.

Phase 2: Claim Task

Atomically claim the task before starting work:

Copybun "$SCRIPTS_PATH/task-claim.js" --project {PROJECT} --team {SUB_TEAM} --id {TASK_ID} --owner ${CLAUDE_SESSION_ID}

If claim fails (conflict): Another worker took it. Find a different task.

Phase 3: Implement

Execute the task using your specialization:

1. Read the task description carefully
2. Use tools (Read, Write, Edit, Bash)
3. Follow existing patterns in the codebase
4. Keep changes focused on the task scope

Phase 4: Verify & Collect Evidence

For each deliverable, collect concrete evidence:

Exit code requirement: All command evidence MUST include exit code.

Phase 5: Update Task Status (CRITICAL)

This phase is MANDATORY. Never skip it.

On Success

Mark task as resolved with evidence:

Copybun "$SCRIPTS_PATH/task-update.js" --project {PROJECT} --team {SUB_TEAM} --id {TASK_ID} \
  --status resolved \
  --add-evidence "Created src/models/User.ts (85 lines)" \
  --add-evidence "npm test: 12/12 passed, exit code 0" \
  --owner ${CLAUDE_SESSION_ID}

On Failure

Add failure evidence and release the task for another worker:

Copy# Add evidence of what went wrong
bun "$SCRIPTS_PATH/task-update.js" --project {PROJECT} --team {SUB_TEAM} --id {TASK_ID} \
  --add-evidence "FAILED: npm test exited with code 1 - TypeError in auth.ts:42" \
  --owner ${CLAUDE_SESSION_ID}

# Release task for retry by another worker
bun "$SCRIPTS_PATH/task-update.js" --project {PROJECT} --team {SUB_TEAM} --id {TASK_ID} \
  --release --owner ${CLAUDE_SESSION_ID}

Do NOT mark as resolved if failed - release for retry.

---

Phase 6: Commit Changes

After task is marked resolved, commit ONLY the files you modified:

⚠️ CRITICAL: Selective File Staging

Copy# ❌ FORBIDDEN - NEVER use these:
git add -A        # Stages ALL files
git add .         # Stages ALL files
git add --all     # Stages ALL files
git add *         # Glob expansion - dangerous

# ✅ REQUIRED - Only add files YOU modified during this task:
git add path/to/file1.ts path/to/file2.ts && git commit -m "$(cat <<'EOF'
<type>(<scope>): <short description>

[teamwork] Project: {PROJECT} | Team: {SUB_TEAM} | Task: {TASK_ID}

{TASK_TITLE}

Evidence:
- {evidence 1}
- {evidence 2}

Files changed:
- path/to/file1.ts
- path/to/file2.ts
EOF
)"

Why selective staging?

• Other workers may have uncommitted changes in the repo
• Only YOUR task changes should be in this commit
• Enables clean rollback per task if needed

Angular Commit Message Types:

Skip commit if:

• No files changed (git status --porcelain is empty)
• Task not resolved (failed/released)

---

Summary Checklist

Before ending your work, verify:

• Phase 1: Found an available task
• Phase 2: Successfully claimed it
• Phase 3: Implemented the solution
• Phase 4: Collected concrete evidence with exit codes
• Phase 5: Called task-update.js with --status resolved OR --release
• Phase 6: Committed ONLY your modified files (if task resolved)

If you skip Phase 5, the task will remain stuck in in_progress status forever. If you skip Phase 6, your changes may be lost or mixed with other workers' changes.