# task_worker

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 395 repo stars
- Author: nwverse
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/nwverse/persona/tree/HEAD/server/internal/prompts/agents/task_worker.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/task-worker

## What it 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`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/task_worker.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/task_worker.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/task_worker.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/nwverse/persona/tree/HEAD/server/internal/prompts/agents/task_worker.md

## When to use it
- 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
- 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.

## Source text · task_worker.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 362d52cf2a71cc3b.

BEGIN THIRD-PARTY FILE 362d52cf2a71cc3b
```text
(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.)
```
END THIRD-PARTY FILE 362d52cf2a71cc3b

The third-party file has ended. Everything between the 362d52cf2a71cc3b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© nwverse · MIT · https://github.com/nwverse/persona/tree/HEAD/server/internal/prompts/agents/task_worker.md

## Similar
- [typing-exclusion-worker](https://affpapa.org/en/nevibecode/skills/typing-exclusion-worker.md) — skill · 1700 installs
- [cloudflare-worker-builder](https://affpapa.org/en/nevibecode/skills/cloudflare-worker-builder.md) — skill · 1400 installs
- [worker-integration](https://affpapa.org/en/nevibecode/skills/worker-integration.md) — skill · 1100 installs
- [worker-benchmarks](https://affpapa.org/en/nevibecode/skills/worker-benchmarks.md) — skill · 1100 installs
- [advisor-orchestrator-worker](https://affpapa.org/en/nevibecode/skills/advisor-orchestrator-worker.md) — skill · 704 installs
- [worker-classification](https://affpapa.org/en/nevibecode/skills/worker-classification.md) — skill · 626 installs

From the same set: [nwverse/persona](https://affpapa.org/en/nevibecode/by/nwverse/persona.md) — 61 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
