빌드/린트 에러 자동 수정. Use when: ruff error, mypy error, TypeError, ImportError, SyntaxError, Build failed, tsc error, eslint error, next build failed, 빌드 실패, 린트 에러, 타입 에러, ModuleNotFoundError. NOT for: 런타임 로직 버그, 비즈니스 로직 에러.
빌드/린트 에러 감지 시 자동 실행. 최소 변경으로 근본 원인 수정.
Stack Detection: CLAUDE.md 규칙에 따라 자동 결정됨.
| 에러 유형 | 자동 수정 |
|---|---|
| Ruff lint | poetry run ruff check --fix . |
| Ruff format | poetry run ruff format . |
mypy missing return | 반환 타입 추가 |
mypy incompatible type | 타입 힌트 수정 |
ModuleNotFoundError | poetry add <pkg> |
ImportError| import 경로 수정 |
SyntaxError | 코드 구문 수정 |
수정 후: poetry run ruff check . && poetry run mypy --strict app/
| 에러 유형 | 자동 수정 |
|---|---|
| ESLint error | pnpm eslint --fix . |
| Prettier format | pnpm prettier --write . |
| tsc type error | 타입 정의 수정 |
| Module not found | pnpm add <pkg> 또는 import 경로 수정 |
| next build error | 빌드 설정 또는 코드 수정 |
수정 후: pnpm tsc --noEmit && pnpm eslint .
Build Fix: [N errors fixed] [BE/FE]
- [에러 유형]: [수정 내용] (파일:라인)
→ 재검증: [PASS/FAIL]
자주 발생하는 실수는 이 디렉토리의 gotchas.md를 참조하라.