---
title: "C++ build error resolver: review, role & definition · Undominated.ai"
canonical: https://undominated.ai/agents/ecc-cpp-build-resolver/
description: "Diagnoses compilation, CMake, linking and template errors through a small-edit, rebuild and test loop."
---

# C++ build error resolver: review, role & definition · Undominated.ai

> Diagnoses compilation, CMake, linking and template errors through a small-edit, rebuild and test loop.

[← Explore all agents](/agents/)

BUILD AND RUNTIME DIAGNOSTICS / Affaan Mustafa

# C++ build error resolver

Diagnoses compilation, CMake, linking and template errors through a small-edit, rebuild and test loop.

 [Use this definition ↓](#setup)[Original source ↗](https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/agents/cpp-build-resolver.md)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 3 linked sources
 Publisher Affaan Mustafa
 Licence [MIT ↗](https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/LICENSE)
 Revision b92f181b3b74
 [Read what was—and wasn’t—checked ↓](#review)

“C++ build, CMake, and compilation error resolution specialist. Fixes build errors, linker issues, and template errors with minimal changes. Use when C++ builds fail.”

 [Affaan Mustafa · upstream description ↗](https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/agents/cpp-build-resolver.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It distinguishes missing symbols, duplicate definitions, include problems and template deduction failures.
- Stop conditions include three repeated failures, a growing error count or an architectural change beyond scope.
- It is the edit-capable counterpart to the C++ reviewer: Write and Edit are declared, and the mission is a minimal fix for a compile, CMake, or link error.
- It stops after three failed attempts on the same error, when the fix adds more errors, or when the change would be architectural, and it forbids pragma warning suppression without approval.

### A good fit for

 - Supply the first failing build log, CMake configuration, compiler standard and affected source/header files.
- Receive each repaired location, original error, minimal change and final build status with remaining errors.
- A failing cmake --build or linker error where the intended change is one compile fix, then a rebuild.
- Stopping a session that is about to hide a warning or rewrite a signature to make the build green.

### Weigh up before choosing

 - Its example clang-tidy command hardcodes C++17 and truncates/suppresses diagnostics; adapt it to the actual compile database and preserve complete logs.
- CMake configuration and builds can execute project scripts; clean-first rebuilds can remove build products.
- The definition references separate upstream support material (cpp-coding-standards); it is not packaged here.
- The source selects the sonnet model alias; confirm it exists in the configured host.
- Source-only listing: inspect the upstream context and referenced dependencies before adapting this definition.
- The workflow runs cmake and ctest through Bash and may edit sources. It does not claim those commands are sandboxed.
- It refuses architectural fixes and warning suppression, but it does not define what counts as a signature change that is necessary.
- cpp-coding-standards is referenced and not included.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - agents/cpp-build-resolver.md (complete definition)
- LICENSE (applicable redistribution terms)
- Host custom-agent documentation; repository installation guidance where applicable

### Our findings

 - It distinguishes missing symbols, duplicate definitions, include problems and template deduction failures.
- Stop conditions include three repeated failures, a growing error count or an architectural change beyond scope.
- Frontmatter tools are Read, Write, Edit, Bash, Grep, and Glob, so this profile is allowed to change files, unlike the C++ reviewer.
- The workflow is build, read the error, apply one minimal fix, rebuild, then ctest.
- Stop conditions include the same error after three attempts and any fix that needs an architectural change. Pragma suppression needs approval.
- The Markdown file is not a registered subagent until a host loads it from a scanned agents directory.

### Not established by this review

 - No agent was installed or invoked. Host/model compatibility, task accuracy and runtime behaviour were not tested.
- The resource was not executed and its tools were not called.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Use the role in your project.

[Upstream setup instructions ↗](https://code.claude.com/docs/en/sub-agents.md)
 - Read the pinned definition and MIT licence; review the host permissions before use.
- Inspect the complete upstream context, place the agent in .claude/agents/ and limit edits/commands to a disposable checkout and the failing target.
- Supply the first failing build log, CMake configuration, compiler standard and affected source/header files.

### Before you start

 - Claude Code and a supported model
- The project-specific C++ toolchain, dependencies and a reproducible failure

### Compatibility

Claude Code

### Implementation

Markdown

### Host-mediated repository and tool access

 - Declared tools: Read, Write, Edit, Bash, Grep, Glob. The host enforces tool access; shell execution can modify files or contact services.

### Cost model

The definition is reusable under its stated licence. Host/model usage, execution environments and connected services can incur separate charges.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Complete upstream definition at reviewed commit ↗](https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/agents/cpp-build-resolver.md) Checked 2026-10-14 https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/agents/cpp-build-resolver.md Supports: Workflow, inputs and outputs, Declared tools and constraints, Selection and limitations
- [Applicable upstream redistribution licence ↗](https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/LICENSE) Checked 2026-10-14 https://github.com/affaan-m/everything-claude-code/blob/b92f181b3b748d1abbc2afd94af6aa7d8c8fca29/LICENSE Supports: Licence and attribution requirements
- [Host custom-agent configuration ↗](https://code.claude.com/docs/en/sub-agents.md) Checked 2026-10-14 https://code.claude.com/docs/en/sub-agents.md Supports: Host setup and permission defaults

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Dart/Flutter build error resolver ↗ Diagnoses analyzer, platform build, package-resolution and generated-code failures with bounded changes.](/agents/ecc-dart-build-resolver/)[### Go build error resolver ↗ Resolves Go compiler, module, vet and linter failures while keeping changes bounded to the reported build problem.](/agents/ecc-go-build-resolver/)[### PyTorch build error resolver ↗ Traces tensor shapes, devices and gradient paths to diagnose a bounded training or inference crash.](/agents/ecc-pytorch-build-resolver/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Find reusable instructions](/skills/)
- [Inspect connections](/mcp-servers/)
- [Build a toolkit](/tools/)
- [Choose the model](/compare/)
