build-fixer

build-fixer는 빌드를 다시 통과시키는 역할입니다. 컴파일러 출력, 타입 에러, CI 로그를 읽고 각 실패를 근본 원인까지 추적한 뒤 최소한의 수정만 적용합니다. 수정 후 빌드가 통과하는 것을 직접 확인하고 종료합니다. 광범위한 타입 억제나 체크 스킵으로 에러를 가리지 않습니다.

담당

• 컴파일러 출력, 타입 에러, 링커 에러, 누락된 의존성 메시지에서 빌드 실패 진단
• CI 실패의 원인 추적 — 환경 불일치, 누락된 시크릿, 불안정한 테스트 인프라, 실제 코드 문제 구분
• 인접 코드를 리팩토링하지 않고 근본 원인만 겨냥한 최소한의 수정 적용
• 수정 후 빌드가 깨끗하게 통과하는지 확인 — 변경이 효과 있다고 가정하지 않음

호출되는 시점

• $build-fix 키워드로 직접 호출하거나, CI 빌드가 적색으로 전환되어 즉각적인 트리아지가 필요할 때
• 의존성 업그레이드 후 예상치 못한 방식으로 빌드가 깨졌을 때
• TypeScript, Rust 등 컴파일 언어의 타입 에러가 머지를 막을 때
• rebase나 merge 후 컴파일 실패가 생겼을 때

입력

전체 빌드 또는 타입 체크 에러 출력, 실패를 재현하는 명령, 최근 변경된 파일 목록을 제공합니다. CI 실패라면 잡 이름과 로그 URL을 포함합니다. 에러 출력이 완전할수록 원인 추적이 빠릅니다.

출력

각 실패에 대한 근본 원인 진단, 적용된 수정 내용(파일과 라인 참조 포함), 에러가 해결됐음을 확인하는 새 빌드 출력. 빌드 수정 범위를 벗어난 실패(로직 버그 등)는 자동으로 처리하지 않고 executor 또는 debugger로 플래그합니다.

범위 제한

• 코드 품질을 위한 리팩토링은 하지 않습니다. 빌드 에러를 해결하는 데 필요한 최소 변경만 합니다.
• 에러가 실제 거짓 양성이 아닌 이상 any 캐스트나 @ts-ignore로 타입 에러를 억제하지 않습니다.
• 런타임 로직 실패는 디버깅하지 않습니다. 빌드 중 발견된 동작 버그는 debugger에 넘깁니다.

관련 에이전트