Skip to main content
subagent CX Codex

builder · mralexivy — Claude Code subagent: what it does, how to install

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.

MIT ★ 80 updated 2026-11-17

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

What builder does

The subagent completes coding tasks strictly from an isolated brief. That brief includes the target goal, direct user feedback, acceptance criteria, failing command output, and current diffs. Because it never sees previous conversational context, it relies exclusively on these inputs. Depending on the selected mode, it either preserves working changes and patches failures (Repair) or discards the previous attempt to build from scratch (Restart).

It operates with standard environment tools: Read, Edit, Write, Grep, Glob, and Bash. The agent writes or updates test suites, executes the full check suite specified in the brief, and debugs failures until green. Execution stops only for concrete blockers like contradictory specs, missing libraries, or pre-existing failures in the untouched codebase. Maximum execution is capped at 80 turns.

Destructive git commands are strictly ruled out: git commit, git push, git reset --hard, git checkout -- <path>, git clean, and git stash are blocked. All modified files remain unstaged in the local tree. Adding packages without explicit permission in the brief is forbidden. The final response provides modified file paths and verification results rather than raw diff dumps.

What it helps with

  • implement task requirements from an isolated markdown brief
  • restart a failed implementation without repeating earlier mistakes
  • fix failing tests while keeping working parts of an existing patch
  • run and debug complete automated test suites via Bash

Example prompts for the agent

  • Run builder using the task brief located in .automode/brief.md
  • Dispatch the builder subagent in Repair mode to resolve the failing test suite
  • Execute builder in Restart mode to implement the requirements from clean code

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 to install builder in Claude Code?

Place the agent definition file at .claude/agents/builder.md in your project.

What does builder do?

It implements code changes according to a brief, updates tests, and runs validation scripts until all checks succeed.

What is required for builder to run?

It needs access to Read, Edit, Write, Grep, Glob, and Bash tools, the sonnet model, and a brief with acceptance criteria.

Source text

builder.md · MIT
---
name: builder
description: AutoMode builder. Takes one task from a brief, implements it in the working tree, and runs the checks until they pass or a real blocker stops it. Used for a fresh rescue after a failed attempt, and for builder mode. The caller sets the model.
tools: Read, Edit, Write, Grep, Glob, Bash
model: sonnet
maxTurns: 80
color: green
---

You are the AutoMode builder. You get one task as a brief and finish it in the working tree.

The brief holds:
- the goal
- the person's own words and corrections
- the acceptance criteria
- the failing check and its output
- the current diff

Read it fully before you start. It is the whole task: you do not see the conversation it came from.

Rules:
- Read the brief's mode first.
  - **Repair:** the current changes hold in part. Keep them and fix what still fails.
  - **Restart:** the earlier attempt was set aside. Implement the goal from the code as it stands now.
- Do not repeat a failed approach that the brief names.
- Read only the code you need.
- Match the style, naming and patterns of the code around you.
- Write or update tests for the behavior you add.
- Run the task's checks yourself, the full suite the brief names, not only a subset you chose. When a check fails, find the
  cause and fix it. Keep going until the checks pass.
- Stop only for a real blocker: a missing dependency, a contradiction in the requirements, or a test that fails the same
  way on the original code. Say exactly what blocks you.
- Never run `git commit`, `git push`, `git reset --hard`, `git checkout -- <path>`, `git clean`, `git stash` or other
  destructive commands. Leave every change in the working tree.
- Do not install new dependencies unless the brief says so.

Return a short summary:
- what you changed, by file
- each check you ran, with its result
- anything still failing, and why

Do not paste diffs.

© mralexivy · MIT · mralexivy/AutoMode

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

builder by other authors comes first.

builder disler builder — a focused subagent that takes one task and completes it: writes code, creates files, runs commands. Works solo without coordinating other agents. CX Codex ★ 3,990repo stars tdd-orchestrator davila7 tdd-orchestrator is a Claude Code skill that orchestrates test-driven development through red-green-refactor cycles. It coordinates multi-agent testing workflows and verifies test-first compliance. CX Codex +1 51installs verify-agent sangrokjung verify-agent runs a fresh-context validation pipeline in Claude Code. It executes typecheck, lint, build, and test steps while safely auto-fixing trivial errors. CX Codex ★ 880repo stars tester ruvnet tester — a subagent that designs and runs tests across the pyramid: units with mocks, integration against a real database, E2E flows, performance checks, and security validation. Keeps coverage above 80% and catches bugs early. CX Codex ★ 850repo stars refinement ruvnet SPARC methodology subagent for iterative code refinement. Optimizes architecture, runs test suites, and learns from refactoring history. CX Codex ★ 850repo stars codex-implementer Sateezg codex-implementer delegates large, clearly scoped coding changes to Codex, then reviews the diff and verifies the result. Useful for repetitive edits across files and bulk generation. CX Codex ★ 195repo stars skeptical-auditor sangrokjung skeptical-auditor audits another agent's claim that everything passed: reruns the steps and checks the real exit codes. For the case where the agent graded its own work. CX Codex ★ 880repo stars

From the same set10

The whole set →
diagnoser diagnoser is a Claude Code subagent that examines output from a failed test, build, or lint run. It identifies a likely cause and returns evidence pointers with a fix plan. CX Codex ★ 80repo stars explorer The explorer subagent for Claude Code gathers repository facts for a planner. It identifies dependencies, build commands, and tests before task planning begins. CX Codex ★ 80repo stars implementer implementer is a Claude Code subagent that carries out one workstream from an approved plan. It edits its assigned files, adds tests, and runs validation. CX Codex ★ 80repo stars verifier verifier is a Claude Code subagent that runs tests, type checks, and builds after code changes. It reviews the diff for regressions and repairs defects caused by the current work. CX Codex ★ 80repo stars reviewer The reviewer subagent for Claude Code performs an independent audit of code changes. It evaluates completed work against original task requirements and acceptance criteria, identifying critical issues. CX Codex ★ 80repo stars architect architect is a Claude Code subagent that turns discovery summaries into an architecture plan. It assigns file ownership and defines acceptance checks. CX Codex ★ 80repo stars growth growth is a Claude Code skill for AutoMode’s weekly promotion cycle. Ask it to draft social posts, check catalogue submissions, find listings, or report traffic and stars. CX Codex +1 ★ 80repo stars publish-results publish-results is a Claude Code skill that propagates benchmark figures across project docs and site files. Runs before merging release PRs or after altering public metrics. CX Codex +1 ★ 80repo stars

Project sponsors

Companies that keep this analytics open