iCode Agent · 가이드 · 워크플로
모듈을 리팩터링하세요.
리팩터링은 대부분 이해의 작업입니다. 무엇이 이것을 호출하고, 이것이 무엇을 호출하며, 형태가 바뀌는 동안 무엇이 계속 참이어야 하는지 파악해야 합니다. iCode Agent는 편집 전에 실제 코드로 그 관계를 파악합니다.
작업
모듈과 원하는 변경을 지정한 뒤, 먼저 영향 범위를 파악하게 하세요:
Refactor src/report/builder.ts. Extract the formatting into a separate module, update all callers, and make sure the tests still pass.
파일을 지정하면 작업 범위가 정해집니다. 변경 위치가 확실하지 않으면 목표를 설명하고 에이전트가 경계를 찾게 하세요. 다만 대상을 지정하면 변경이 더 집중됩니다.
진행 과정
- 범위 파악.
grep과find로 모듈의 호출자를 찾고,read는 줄 번호와 함께 코드를 보여 주어 에이전트가 추측이 아니라 구조를 볼 수 있게 합니다. - 변경 계획. 무엇이 이동하고 무엇이 남으며, 어떤 호출자를 모두 업데이트해야 하는지 파악합니다.
- 작은 단계로 편집.
edit은 한 번에 정확한 범위 하나를 교체하고 diff를 보여 주므로, 검토자는 재작성된 파일이 아니라 변경 내용을 봅니다. - 테스트를 통과 상태로 유지. 테스트 스위트를 실행합니다. 리팩터링을 위험한 일이 아니라 안전한 일로 만드는 안전망입니다.
전체를 다시 쓰지 않습니다. edit은 대상 범위를 바꾸고 write는 정말 새로운 파일에만 사용됩니다. 수락하기 전에 diff가 항상 표시됩니다.
diff 검토
여기서 가치가 드러납니다. 에이전트가 제안하고 당신이 결정합니다. 좋은 리팩터링 프롬프트는 결과만이 아니라 검증할 수 있는 근거를 요청합니다:
Refactor the auth module. Show me the callers you found first, then make the smallest change that removes the duplication. Run the tests after each file you touch.
변경이 잘못되면 나중에 되돌리기보다 작업 중에 방향을 조정하세요. 에이전트는 아무것도 커밋하지 않았으므로 방향 전환 비용이 적습니다.
이 워크플로에 좋은 프롬프트
Find every caller of parseConfig() before changing its signature. Extract the duplicated retry logic into one helper and update both call sites. Explain what this module does, then suggest a refactor — but make no edits yet.
마지막 방법은 의도적으로 읽기 전용입니다. 분석을 요청하고, 읽고, 그다음 변경을 요청하세요. 큰 리팩터링에서는 이 방식이 더 나을 때가 많습니다.