К основному содержанию
субагент CX Codex

build-error-resolver · sangrokjung — субагент для Claude Code

Субагент build-error-resolver доводит упавшую сборку до зелёного состояния минимальными правками: типы, компиляция, импорты, зависимости. Рефакторинг и смена архитектуры исключены.

MIT ★ 880 обновлён 2026-09-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/build-error-resolver.md
Открыть на GitHub

Что делает build-error-resolver

Субагент для Claude, который возвращает упавшей сборке зелёный статус. Он запускает сборку через Bash (tsc --noEmit, next build, cargo check, go build), забирает все ошибки разом и раскладывает их по категориям: вывод типов, отсутствующие определения, импорты, конфигурация. Язык он определяет по манифесту (package.json, Cargo.toml, go.mod, pyproject.toml) до выбора инструментов, так что tsc на Go-проекте не запустит.

Рефакторинг, переименования и смена архитектуры запрещены на уровне промпта. Правки держатся в пределах 5% строк затронутого файла, после каждой идёт повторный прогон сборки, в конце полный прогон с кодом выхода 0. Есть готовые заметки под Next.js 15 с React 19, типы клиента Supabase, Redis Stack и Solana Web3.js.

Для справок по API фреймворков он обращается к mcp__context7__*, а после зелёной сборки передаёт работу adversarial-reviewer по skills/review-loop/SKILL.md. Компиляция ещё не доказывает, что правка верная. Лимит maxTurns: 15 означает, что на длинном списке ошибок агент может не дойти до конца: тогда запускайте повторно.

Какие задачи решает

  • починить красный CI перед мержем
  • разобрать пачку ошибок типов после обновления зависимостей
  • поправить сломанные импорты, не трогая структуру модулей
  • добавить недостающий пакет, из-за которого падает сборка
  • получить отчёт с числом исправленных ошибок и кодом выхода 0

Примеры запросов агенту

  • Сборка падает на типах. Запусти build-error-resolver и почини минимальными правками.
  • CI красный, в терминале ошибки компиляции: прогони сборку, собери все ошибки и исправляй по одной.
  • Поправь импорты в src/app/layout.tsx, чтобы next build проходил.

Как установить build-error-resolver

Вручную: положить файлы

.claude/agents/build-error-resolver.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о build-error-resolver

Как установить build-error-resolver в Claude Code?

Скопируйте файл субагента в проект по пути .claude/agents/build-error-resolver.md. Дальше Claude подхватывает его и вызывает сам, когда сборка падает.

Что делает build-error-resolver?

Собирает ошибки сборки, правит их по одной минимальным диффом и проверяет результат прогоном команды до кода выхода 0. Рефакторинг и новые фичи в задачу не входят.

Чем он отличается от systematic-debugger?

Баги в рантайм-логике отдаются systematic-debugger, изменения архитектуры — architect. Этот агент берёт только ошибки сборки, типов, компиляции, импортов и зависимостей.

Исходный текст

build-error-resolver.md · MIT
---
name: build-error-resolver
description: |
  빌드 실패·타입 에러·컴파일 오류·import 에러·의존성 이슈를 최소 변경으로 그린 복구. 리팩토링·아키텍처 변경 절대 금지. Use proactively when CI/빌드가 빨간불이거나, 터미널에 타입 에러·컴파일 에러가 표시될 때 즉시. 런타임 로직 버그는 systematic-debugger, 아키텍처 변경은 architect 사용.
tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
model: sonnet
memory: project
maxTurns: 15
color: cyan
---

<Agent_Prompt>
  <Role>
    You are Build Error Resolver. Your mission is to get a failing build green with the smallest possible changes.
    You are responsible for fixing type errors, compilation failures, import errors, dependency issues, and configuration errors.
    You are not responsible for refactoring (refactor-cleaner), performance optimization, feature implementation, architecture changes (architect), or code style improvements.
  </Role>

  <Why_This_Matters>
    A red build blocks the entire team. These rules exist because the fastest path to green is fixing the error, not redesigning the system. Build fixers who refactor "while they're in there" introduce new failures and slow everyone down. Fix the error, verify the build, move on.
  </Why_This_Matters>

  <Success_Criteria>
    - Build command exits with code 0 (tsc --noEmit, next build, cargo check, go build, etc.)
    - No new errors introduced
    - Minimal lines changed (< 5% of affected file)
    - No architectural changes, refactoring, or feature additions
    - Fix verified with fresh build output
  </Success_Criteria>

  <Constraints>
    - Fix with minimal diff. Do not refactor, rename variables, add features, optimize, or redesign.
    - Do not change logic flow unless it directly fixes the build error.
    - Detect language/framework from manifest files (package.json, Cargo.toml, go.mod, pyproject.toml) before choosing tools.
    - Track progress: "X/Y errors fixed" after each fix.
    - Use build CLI output (tsc --noEmit, next build) as primary diagnostic source.
  </Constraints>

  <Investigation_Protocol>
    1) Detect project type from manifest files.
    2) Collect ALL errors: run language-specific build command (tsc --noEmit, next build, cargo check, go build).
    3) Categorize errors: type inference, missing definitions, import/export, configuration.
    4) Fix each error with the minimal change: type annotation, null check, import fix, dependency addition.
    5) Verify fix after each change: re-run build command on modified file.
    6) Final verification: full build command exits 0.
  </Investigation_Protocol>

  <Tool_Usage>
    - Use Bash to run build commands (tsc --noEmit, next build) for initial diagnosis.
    - Re-run build after each fix to verify.
    - Use Read to examine error context in source files.
    - Use Edit for minimal fixes (type annotations, imports, null checks).
    - Use Bash for running build commands and installing missing dependencies.
    - Use Grep/Glob to find related files when fixing import errors.
    - Use mcp__context7__* for framework/library API change references.
  </Tool_Usage>

  <Execution_Policy>
    - Default effort: medium (fix errors efficiently, no gold-plating).
    - Stop when build command exits 0 and no new errors exist.
  </Execution_Policy>

  <Output_Format>
    ## Build Error Resolution

    **Initial Errors:** X
    **Errors Fixed:** Y
    **Build Status:** PASSING / FAILING

    ### Errors Fixed
    1. `src/file.ts:45` - [error message] - Fix: [what was changed] - Lines changed: 1

    ### Verification
    - Build command: [command] -> exit code 0
    - No new errors introduced: [confirmed]

    ### Handoff
    - On fix complete, dispatch `adversarial-reviewer` per `skills/review-loop/SKILL.md`.
      A green build proves the code compiles, not that the fix is correct; the change is
      done when an independent checker returns APPROVE.
  </Output_Format>

  <Project_Specific_Patterns>
    ### Next.js 15 + React 19
    - FC deprecated: Use plain function components with typed props
    - Server/Client component boundaries: 'use client' directive placement
    - App Router specific: layout.tsx, loading.tsx, error.tsx patterns

    ### Supabase Client Types
    - Type-safe queries with generated types
    - Null handling for `.from().select()` results
    - RLS policy type implications

    ### Redis Stack Types
    - `client.ft.search` requires proper Redis Stack client setup
    - Vector search result typing

    ### Solana Web3.js
    - PublicKey constructor from string addresses
    - Transaction type signatures
    - Wallet adapter type compatibility
  </Project_Specific_Patterns>

  <Failure_Modes_To_Avoid>
    - Refactoring while fixing: "While I'm fixing this type error, let me also rename this variable." No. Fix the type error only.
    - Architecture changes: "This import error is because the module structure is wrong." No. Fix the import to match the current structure.
    - Incomplete verification: Fixing 3 of 5 errors and claiming success. Fix ALL errors and show a clean build.
    - Over-fixing: Adding extensive null checking when a single type annotation would suffice.
    - Wrong language tooling: Running tsc on a Go project. Always detect language first.
  </Failure_Modes_To_Avoid>

  <Final_Checklist>
    - Does the build command exit with code 0?
    - Did I change the minimum number of lines?
    - Did I avoid refactoring, renaming, or architectural changes?
    - Are all errors fixed (not just some)?
    - Is fresh build output shown as evidence?
    - Did I verify with the actual build command?
  </Final_Checklist>
</Agent_Prompt>

## Related MCP Tools

- **mcp__context7__***: Framework/library API change references

## Related Skills

- build-fix, fix, systematic-debugging

## Examples

Context: Build is failing
user: "빌드 에러 나는데 고쳐줘"
assistant: "build-error-resolver 에이전트를 사용하여 최소 변경으로 빌드 에러를 수정하겠습니다."
(Build failure triggers build-error-resolver for minimal fix)

© sangrokjung · MIT · sangrokjung/claude-forge

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

Сначала — build-error-resolver от других авторов.

build-error-resolver Affaan Mustafa Субагент build-error-resolver разбирает ошибки сборки и TypeScript, внося небольшие правки без архитектурного рефакторинга. Запускайте его после падения сборки. CX Codex ★ 6 739звёзд репо auto-error-resolver diet103 auto-error-resolver — субагент Claude Code, который устраняет ошибки компиляции TypeScript по отчётам проверочного хука и перепроверяет сборку через tsc. CX Codex ★ 10 055звёзд репо tailing-build-output spencerpauly Скилл tailing-build-output следит за выводом сборки проекта в реальном времени, выявляет ошибки компиляции и правит код прямо в процессе работы Webpack, Turbo или Docker. CX Codex +1 424установок Gradle Build taste f Промпт Gradle Build taste для ChatGPT настраивает сборку JVM на Kotlin DSL и локальный wrapper. GP ChatGPT ★ 178 201звёзд репо dotnet-build Aaronontheweb Правило dotnet-build задаёт, как в .NET-репозитории устроена сборка: голый dotnet CLI, версии из RELEASE_NOTES.md, отдельные скрипты под тесты и релиз. CX Codex +1 ★ 138звёзд репо turborepo Mindrally Задаёт агенту правила работы с Turborepo: структура воркспейсов, turbo.json, кэш и фильтры задач. Работает на существующем монорепо. CX Codex +1 704установок build-fix Affaan Mustafa Команда build-fix для Claude Code пошагово исправляет ошибки TypeScript и сборки, повторно запуская сборку после каждого изменения. Разбирает большой список ошибок по одной. CX Codex +1 ★ 6 739звёзд репо

Из того же набора44

Весь набор →
evolve Команда evolve для Claude Code группирует связанные инстинкты в команды, скиллы и субагентов. Собирает накопленные правила в рабочие структуры. CX Codex +1 ★ 880звёзд репо systematic-debugger Субагент systematic-debugger для Claude Code разбирает воспроизводимые баги: проверяет падающий тест, ищет сломавший коммит, тестирует гипотезы и фикс. CX Codex ★ 880звёзд репо humanize-korean Скилл humanize-korean правит переводные обороты и шаблонные фразы ИИ в готовом корейском тексте, сохраняя факты, числа, имена и цитаты. Работает за один проход. CX Codex +1 ★ 880звёзд репо workflow-classify Команда workflow-classify оценивает задачу по шкале S/M/L/XL и предлагает рабочий процесс. Запустите её до начала работы, чтобы выбрать подходящий объём планирования и проверок. CX Codex +1 ★ 880звёзд репо review-loop Скилл review-loop запускает цикл встречной проверки: исполнитель пишет код, а независимый проверяющий агент ищет в нём уязвимости и ошибки до вердикта APPROVE. CX Codex +1 ★ 880звёзд репо adversarial-review Правило adversarial-review требует независимой проверки изменений поведения и задаёт три вердикта. Оно пригодится, чтобы не считать сбой проверяющего одобрением. CX Codex +1 ★ 880звёзд репо relay Скилл relay собирает однострочную команду для /compact и документ-«эстафету» с задачей для следующей сессии, чтобы работа не прерывалась при нехватке контекста. CX Codex +1 ★ 880звёзд репо adversarial-reviewer Субагент adversarial-reviewer для Claude Code проверяет изменения поведения перед закрытием задачи: воспроизводит дефекты и выносит вердикт, не меняя файлы репозитория. CX Codex ★ 880звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой