에이전트에게 폴더를 맡기기 전에 해둘 6가지

최종 수정: 2026년 8월 23일

잘 쓰는 방법 · 읽는 시간 6분

에이전트에게 폴더를 맡기면 파일이 실제로 바뀝니다. 되돌리기 버튼은 없습니다. 그래서 시작 전 몇 가지를 해두면 사고가 사고로 끝나지 않습니다.

1. 되돌릴 수 있는 상태를 만든다

가장 강한 안전장치입니다. 순서대로 강합니다.

  1. 버전 관리에 커밋 — 무엇이 어떻게 바뀌었는지 줄 단위로 볼 수 있고, 한 번에 되돌릴 수 있습니다.
  2. 폴더 복사 — 투박하지만 확실합니다. 버전 관리를 안 쓰는 문서 폴더에 좋습니다.
  3. 아무것도 안 함 — 권하지 않습니다.

커밋해 두면 작업 후 변경 내역만 훑어봐도 에이전트가 무엇을 했는지 정확히 알 수 있습니다. 결과를 검토하는 시간이 절반으로 줄어듭니다.

2. 폴더를 좁게 고른다

프로젝트 최상위를 열면 에이전트가 볼 것이 너무 많아집니다. 문제는 두 가지입니다.

  • 엉뚱한 파일을 고칠 여지가 생깁니다.
  • 폴더를 훑는 데 창을 많이 씁니다. 그만큼 실제 작업에 쓸 여유가 줄어듭니다.

"로그인 화면 문구를 고쳐 줘"라면 해당 화면이 있는 폴더만 열면 됩니다. 범위를 좁히는 것이 결과 품질에도 직접 도움이 됩니다.

3. 지시를 결과가 아니라 조건으로 쓴다

"코드 정리해 줘"는 위험한 지시입니다. 무엇이 정리인지 에이전트가 정하게 됩니다. 조건을 주면 결과가 예측 가능해집니다.

  • X "이 파일 정리해 줘"
  • O "이 파일에서 쓰이지 않는 import 만 지워 줘. 함수는 건드리지 마."
  • X "버그 고쳐 줘"
  • O "합계가 1 적게 나와. calc 함수만 보고 원인을 찾아서 고쳐 줘."

건드리지 말 것을 명시하는 한 줄이 특히 값이 큽니다.

4. 먼저 읽게 하고, 그 다음에 고치게 한다

바로 고치라고 시키는 것보다 이 순서가 사고가 적습니다.

  1. "이 폴더 구조를 보고 무엇이 있는지 알려 줘"
  2. "고쳐야 할 부분이 어디라고 생각해? 고치지는 말고"
  3. (판단이 맞으면) "그럼 그렇게 고쳐 줘"

두 번째 단계에서 엉뚱한 답이 나오면, 그 상태로 고치게 했을 때 무슨 일이 났을지 알 수 있습니다. 10초 투자로 되돌릴 수 없는 수정을 막습니다.

5. 확인 창을 습관적으로 누르지 않는다

수정 전에 확인을 받도록 되어 있습니다. 이 창은 방해물이 아니라 마지막 방어선입니다.

  • 파일 경로를 보세요. 예상한 파일인가요?
  • 여러 파일을 연달아 고치겠다고 하면, 그 목록이 납득되는지 보세요.
  • 납득되지 않으면 거절하고 이유를 물어보세요. "왜 그 파일을 고쳐야 하는지 먼저 설명해 줘"

6. 끝나면 결과를 직접 본다

에이전트는 "고쳤습니다"라고 말합니다. 그 말이 맞는지는 사람이 봐야 합니다.

  • 버전 관리를 쓰면 변경 내역을 훑습니다.
  • 아니면 고쳤다고 한 파일을 열어 봅니다.
  • 코드라면 실제로 돌려 봅니다. 브라우저 판은 명령을 실행할 수 없으니 이 단계는 사람 몫입니다.

정리

하기이유
커밋 또는 복사되돌릴 수 있으면 대부분의 사고가 사고가 아니게 된다
폴더 좁게 열기사고 범위와 창 사용량이 함께 줄어든다
건드리지 말 것 명시예측 가능한 결과가 나온다
읽기 → 판단 → 수정잘못된 판단을 수정 전에 잡는다
확인 창 읽기마지막 방어선이다
결과 직접 확인"고쳤습니다"는 보고일 뿐이다

이어서 읽을 만한 것

← 가이드 목록으로 · 옵저바 에이전트 써보기