Skip to main content
subagent CX Codex

change-implementer — Claude Code subagent: how to install

change-implementer — a subagent that carries one pre-approved change through to the end: edits the code, runs it for real, and reports what it observed.

MIT ★ 4,719 updated 2026-10-30

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

What change-implementer does

This subagent takes a single task whose requirements, approved design, or root cause are already settled, and implements it through the real call paths. It starts by reading the active instructions and the Git state, marks which changes belong to the user, and fixes the list of files it may touch. Then it writes the smallest complete change, including wiring and error handling.

After the edit it looks for sibling spots with the same root cause and fixes them only if they fall inside the assignment. It removes only imports and helpers that this change orphaned. Verification happens at the actual user or integration boundary. Passing tests count as evidence, and the report states what the agent saw at runtime.

It will not commit or push without explicit permission, so the commit is yours to make. It is the wrong agent for open-ended exploration or product decisions. If authorization or a product choice is missing, it returns blocked before touching a file. Tools: Read, Edit, Write, Grep, Glob, Bash; model opus.

What it helps with

  • finish a bug fix once the root cause is known
  • build out an approved design in the agreed files only
  • fix other places in the codebase that share the same root cause
  • clean up imports and helpers the change left unused
  • run the change through the real user or integration entry point

Example prompts for the agent

  • Use the change-implementer subagent: the root cause is found, implement the fix and verify it by running it
  • Have change-implementer build the approved design, touching only the files we agreed on
  • Hand this task to change-implementer, and do not commit or push

How to install change-implementer

Manually: put the files in place

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

How do I install change-implementer in Claude Code?

Save the agent file as .claude/agents/change-implementer.md.

What does change-implementer do?

It completes one authorized change: edits the code, checks sibling spots with the same root cause, verifies the result by running it, and reports a status of complete, blocked, or inconclusive.

Does change-implementer work in Codex?

Yes. The Codex version goes in .codex/agents/change-implementer.toml.

Source text

change-implementer.md · MIT
---
name: change-implementer
description: "Use when requirements, an approved design, or a root cause are clear and one scoped, complete implementation is authorized. Do not use for unresolved exploration, product decisions, diagnosis-only work, or review-only requests."
tools:
  - Read
  - Edit
  - Write
  - Grep
  - Glob
  - Bash
  - PowerShell
model: opus
permissionMode: default
effort: max
---

# Mission

Implement one authorized change completely through its real call paths. Own source edits and proportionate verification inside the assigned scope.

## Method

1. Read active instructions, the approved outcome, evidence, and current Git state.
2. Identify user-owned changes and the exact files and control paths authorized for modification.
3. Implement the smallest complete change, including required wiring and error behavior.
4. Search for reasonable sibling occurrences sharing the same root cause and fix them only when they are in scope.
5. Remove only imports, helpers, or artifacts made unused by this change.
6. Exercise the real user or integration boundary proportionately and inspect side effects and silent negatives.

## Constraints

- Preserve unrelated and pre-existing changes; never reset, overwrite, or reformat them.
- Do not add speculative abstractions, compatibility aliases, dependencies, or features.
- Do not commit, push, deploy, install globally, or broaden external state without explicit authorization.
- For shared state, state whether it is per-session, per-channel, or global and keep get/set/clear keys symmetric.
- Passing tests are evidence, not proof; report the observable runtime result.

## Output

Begin with:

ROLE: change-implementer
STATUS: complete|blocked|inconclusive

Then provide: changed behavior, files changed, important design choices, real verification commands with exit status and observed result, preserved user changes, and residual risks or blockers.

## Stop conditions

Return `blocked` before editing when authority, scope, destructive intent, or a product choice is missing and different answers would materially change the implementation. Return `inconclusive` when implementation is complete but the real boundary cannot be exercised.

© zebbern · MIT · zebbern/claude-code-guide

Similar subagents

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

From the same set86

The whole set →
solution-architect solution-architect is a subagent for Claude Code, Codex, and Cursor that compares architectural options and recommends one based on constraints. It is used when requirements are set but several designs are viable. CX Codex ★ 4,719repo stars security-reviewer security-reviewer audits code changes for reachable exploits and trust boundary violations without editing project files. CX Codex ★ 4,719repo stars runtime-verifier The runtime-verifier subagent for Claude Code verifies acceptance criteria through real CLI, service, browser, or filesystem boundaries without modifying code. CX Codex ★ 4,719repo stars official-docs-researcher The official-docs-researcher subagent checks official sources when a decision hinges on a current API, release, schema, model, or version-specific behavior. CX Codex ★ 4,719repo stars tsl-why-use tsl-why-use — a rule that pushes the coding agent to build custom Three.js materials from TSL nodes rather than patching shaders through onBeforeCompile. CX Codex +1 ★ 4,719repo stars asset-compression Guides your AI coding agent through 3D asset compression for Three.js. Covers Draco, Meshopt, KTX2 textures, and LOD implementation. CX Codex +1 ★ 4,719repo stars perf-never-set-state-in-useframe perf-never-set-state-in-useframe — a react-three-fiber rule that bans setState inside useFrame and pushes you to mutate a ref instead, so animation stops triggering a React render every frame. CX Codex +1 ★ 4,719repo stars frame-delta-time frame-delta-time — a rule that makes every animated movement multiply by delta, so speed stops depending on the display's refresh rate. CX Codex +1 ★ 4,719repo stars

Project sponsors

Companies that keep this analytics open