Skip to main content
subagent CX Codex

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

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

What 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.ts and check types

How to install builder

Manually: put the files in place

.claude/agents/builder.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 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.

builder mralexivy builder is a Claude Code subagent that takes a standalone task brief, edits the working tree, and loops through project checks until they pass. Runs for rescue attempts and dedicated build tasks. CX Codex ★ 80repo stars speckit.implement alfredoperez speckit.implement — a subagent that reads the task list from tasks.md and executes it step by step, checking prerequisites, loading project artifacts, and following the architecture defined in plan.md. CX Codex +1 ★ 110repo stars speckit.companion.implement alfredoperez The speckit.companion.implement command for Claude Code runs tasks.md in dependency order and keeps iterating toward convergence. It fires hooks around the implement phase. CX Codex +1 ★ 110repo stars quasi-coder official github quasi-coder — a GitHub Copilot skill that turns shorthand, quasi-code and rough descriptions into working code. When collaborators hand you half-finished snippets with typos and wrong terms, this skill fills the gap. CX Codex +1 9,100installs agent-4-code-writer happycapy-ai agent-4-code-writer — a Claude Code subagent that implements fixes or features within an open-source contributor swarm using an existing issue plan and codebase map. CX Codex ★ 138repo stars platform-apex-generate forcedotcom The platform-apex-generate skill guides Apex class creation, refactoring, and review. Use it for services, triggers, asynchronous jobs, REST resources, and related code checks. CX Codex +1 7,600installs docstring pipecat-ai Adds Google-style docstrings to Python modules and classes automatically. Fills in missing documentation without modifying existing complete descriptions. CX Codex +1 ★ 17,367repo stars

From the same set25

The whole set →
crypto_movers_agent_prompt crypto_movers_agent_prompt finds the biggest percentage gainers and losers among cryptocurrencies in the top 100 by market cap. Pass a timeframe such as 7d to change the period. CX Codex +1 ★ 3,990repo stars question Answers questions about a project's layout and docs without touching any files. Use it to get your bearings in a repo. CX Codex +1 ★ 3,990repo stars update_status_line update_status_line upserts custom key-value metadata into Claude Code session records. Useful for displaying custom task statuses or project flags in your status line. CX Codex +1 ★ 3,990repo stars validator The validator subagent checks a task against its acceptance criteria and reports issues. Run it after a builder agent finishes its work. CX Codex ★ 3,990repo stars work-completion-summary work-completion-summary delivers audio debriefs and next steps via ElevenLabs voice synthesis after completing a task. Useful for hands-free progress updates. CX Codex ★ 3,990repo stars crypto_market_agent_prompt The crypto_market_agent_prompt command gathers current figures for leading cryptocurrencies and lays them out in a market table. Use it for a compact price and volume snapshot. CX Codex +1 ★ 3,990repo stars crypto_research_haiku crypto_research_haiku — a command that runs four lightweight agents in parallel to analyze any cryptocurrency. Pass a ticker symbol, get market overview, coin details, macro correlation, and investment ideas in separate files. CX Codex +1 ★ 3,990repo stars llm-ai-agents-and-eng-research llm-ai-agents-and-eng-research gathers recent updates on large language models, agent frameworks, and ML engineering while filtering out content older than seven days. CX Codex ★ 3,990repo stars

Project sponsors

Companies that keep this analytics open