# builder

builder — a focused subagent that takes one task and completes it: writes code, creates files, runs commands. Works solo without coordinating other agents.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 3990 repo stars
- Author: disler
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/disler/claude-code-hooks-mastery/tree/HEAD/.claude/agents/team/builder.md
- Updated: 2026-03-04
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/builder

## What it does

Builder is a worker subagent that executes assigned tasks with full focus. It reads task details using TaskGet, performs the work, and marks completion via TaskUpdate. It does not plan, coordinate, or expand scope—only executes what is assigned.

Hooks are configured on Write and Edit operations: after each code change, ruff (for style and logic) and type checking validators run automatically. These validators must be present at `$CLAUDE_PROJECT_DIR/.claude/hooks/validators/` and are invoked through `uv run`.

Use it for work requiring sustained focus: refactoring a module, writing a new function, generating a set of files from a template. If a blocker arises, it updates the task with details and attempts a workaround—it does not stop.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/builder.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/builder.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/builder.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/disler/claude-code-hooks-mastery/tree/HEAD/.claude/agents/team/builder.md

## When to use it
- write a function or module from specification
- create multiple files based on a template
- refactor code with automated style validation
- implement a feature with validation at each step

## Example prompts
- Implement a sort function with documentation and types
- Create a logging config and write it to `config/logger.ts`
- Refactor the error handler in `utils/error.ts` and check types

## Similar
- [speckit.implement](https://affpapa.org/en/nevibecode/agents/speckitimplement.md) — subagent · ★ 110 repo stars
- [speckit.companion.implement](https://affpapa.org/en/nevibecode/commands/speckitcompanionimplement.md) — command · ★ 110 repo stars
- [quasi-coder](https://affpapa.org/en/nevibecode/skills/quasi-coder.md) — skill · 9100 installs
- [agent-4-code-writer](https://affpapa.org/en/nevibecode/agents/agent-4-code-writer.md) — subagent · ★ 138 repo stars
- [platform-apex-generate](https://affpapa.org/en/nevibecode/skills/platform-apex-generate.md) — skill · 7600 installs
- [docstring](https://affpapa.org/en/nevibecode/skills/docstring.md) — skill · ★ 17367 repo stars

## Other versions with the same name
- [builder · mralexivy](https://affpapa.org/en/nevibecode/agents/mralexivy-builder.md) — ★ 80 repo stars

From the same set: [disler/claude-code-hooks-mastery](https://affpapa.org/en/nevibecode/by/disler/claude-code-hooks-mastery.md) — 25 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
