Skip to main content
subagent CX Codex

task_worker — Claude Code subagent: purpose and setup

The task_worker Claude Code subagent handles an assigned part of a larger task. It can use in-session subagents but cannot pass work to other Persona tasks.

MIT ★ 395 updated 2026-11-16

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/task_worker.md
Open on GitHub

What task_worker does

task_worker carries out the work assigned by a lead and keeps it within its own Persona task. It can use subagents in the current session. The lead reviews the result when the work ends and may return it for changes.

Before pushing code, releasing, messaging other people, or changing someone else’s PR, the subagent stops to ask the user for approval, unless that action is the entire assignment. For Claude Code, place the agent file at .claude/agents/task_worker.md; the Codex path is .codex/agents/task_worker.toml, and Cursor uses .cursor/agents/task_worker.md.

What it helps with

  • complete an assigned portion of a larger task
  • keep work from being passed to other Persona tasks
  • get approval before publishing code or changing someone else’s PR

Example prompts for the agent

  • Complete this part of the task and report the result to the lead.
  • Review these changes and ask before pushing the code.
  • Split this work among subagents in the current session.

How to install task_worker

Manually: put the files in place

.claude/agents/task_worker.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about task_worker

How do I install task_worker in Claude Code?

Add the agent file at .claude/agents/task_worker.md.

What does task_worker do?

It handles work assigned by a lead and reports back for review. It can use subagents in its session but cannot delegate to other Persona tasks.

Can task_worker push code or modify someone else’s PR?

It must stop and ask the user before pushing code, releasing, messaging other people, or changing someone else’s PR, unless that action is the whole assignment.

Source text

task_worker.md · MIT
(Persona: this task was handed to you by the leader of a larger task, not typed by the user. Do the work here yourself; you cannot hand it on to other Persona tasks, and in-session subagents are fine. Your leader supervises you: when you stop, it checks what you did against the "done when" above and either accepts it or sends back what is missing. If you have the Persona tool report_to_supervisor, it reaches your leader, not the user: report what you found, what blocks you and, when you finish, a done report with evidence (paths on this computer, branches, command output). Before pushing code, deploying or releasing, sending messages or comments to other people, or merging or changing someone else's PR, stop and ask the user, unless the task above is only that and says so.)

© nwverse · MIT · nwverse/persona

Similar subagents

Subagents catalog →

From the same set61

The whole set →
dispatch_task The dispatch_task Claude Code subagent takes work from another coding agent and handles it itself. It pauses for approval before actions that affect others or external systems. CX Codex ★ 395repo stars task_retry The task_retry subagent for Claude Code restarts a task's agent after a failed launch. It reuses the existing tab when possible, or opens a new one. CX Codex ★ 395repo stars agent_read This Claude Code subagent reads a selected agent’s recent conversation. It answers follow-up questions about completed work, conclusions, or why the agent stopped. CX Codex ★ 395repo stars session_name The session_name Claude Code subagent names a session after the task being discussed. It uses the opening message and recent dialogue to reflect a change in direction. CX Codex ★ 395repo stars codex_continuation The codex_continuation Claude Code subagent picks up a task from a separate Codex conversation in a fresh session. It uses recent messages to recover decisions, constraints, and unfinished work. CX Codex ★ 395repo stars question_released The question_released Claude Code subagent ends the current turn when another message arrives while a question awaits the user’s answer. The question card stays unchanged, and the answer returns in a later message. CX Codex ★ 395repo stars direction_name The direction_name Claude Code subagent assigns a name to a direction linked to a leader conversation. The app and work-log extension display that label. CX Codex ★ 395repo stars question_moved_to_todo The question_moved_to_todo Claude Code subagent moves an unanswered question into the user's to-do list. It waits for a decision while the agent continues with work that does not depend on it. CX Codex ★ 395repo stars

Project sponsors

Companies that keep this analytics open