Builder · disler — Claude Code subagent: task execution
builder — a focused subagent that takes one task and completes it: writes code, creates files, runs commands. Works solo without coordinating other agents.
no license ★ 3,990 updated 2026-03-04
.claude/agents/builder.mdWhat builder 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.
What it helps with
- 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 for the agent
- 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.tsand check types
How to install builder
Manually: put the files in place
.claude/agents/builder.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/builder.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/builder.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about builder
How do I install Builder in Claude Code?
Copy .claude/agents/builder.md from the disler/claude-code-hooks-mastery repository into your project's .claude/agents/ folder. Builder will then be available as a subagent in Claude Code.
What does Builder do?
It takes one assigned task, reads its description, executes the work (writing code, creating files, running commands), validates the result, and marks the task as completed. It operates independently without spawning or coordinating other agents.
Which validators are included?
After every Write or Edit operation, ruff_validator.py (for code style and logic) and ty_validator.py (for type checking) run automatically. These scripts must be located at $CLAUDE_PROJECT_DIR/.claude/hooks/validators/ and are invoked via uv run.
Similar subagents
All subagents for Agent setup: memory, context, orchestration →builder by other authors comes first.