AI에게 코딩을 맡길 때 확인할 순서
큰 기능을 바로 맡기지 않고 탐색·계획·구현·테스트·리뷰를 증거 중심으로 진행합니다.
코딩 에이전트를 쓰는 개발자
처음부터 모든 기능을 알 필요는 없습니다. 지금 필요한 한 가지 작업에만 적용해 보고, 결과를 직접 확인하는 방법부터 시작하세요.
3분 안에 이해할 핵심
- 파일을 고치기 전에 저장소 규칙과 테스트를 읽게 합니다.
- 작업 범위와 수정 금지 영역을 명시합니다.
- 완료 판단은 설명이 아니라 테스트와 diff로 합니다.
전체 흐름 먼저 보기
- 1
재현 가능한 목표를 줍니다
현재 동작, 원하는 동작과 실패 예시를 함께 제공합니다.
- 2
먼저 읽기 전용 조사를 시킵니다
관련 파일, 데이터 흐름, 기존 테스트와 위험 요소를 요약하게 합니다.
- 3
작은 변경 단위로 구현합니다
UI·API·데이터 변경을 한꺼번에 섞기보다 검증 가능한 단위로 나눕니다.
- 4
테스트와 정적 검사를 실행합니다
성공한 명령과 실행하지 못한 검증을 구분해 보고하게 합니다.
- 5
diff를 별도 관점으로 검토합니다
요구 누락, 보안, 오류 처리와 불필요한 변경을 다시 확인합니다.
직접 해보는 연습
이 글을 보고 완성할 것
작은 오류 하나를 코딩 에이전트에게 맡기고 변경 내용과 테스트 결과를 직접 검토합니다.
시작하기 전에 준비하세요
- Git으로 관리되는 연습용 저장소
- 재현할 수 있는 작은 오류 또는 문구 수정
- 프로젝트의 테스트·빌드 명령
버튼을 눌러도 오류 안내가 보이지 않는 작은 문제를 고친다고 가정합니다. 운영 배포나 데이터베이스 변경은 첫 실습에서 제외합니다.
- STEP 1
현재와 원하는 동작을 재현하기
화면, 입력, 실제 결과, 원하는 결과를 순서대로 적습니다. 가능하면 실패하는 테스트를 먼저 준비합니다.
복사해서 내 상황에 맞게 바꾸세요현재: 빈 입력으로 저장 버튼을 누르면 아무 안내가 없다. 원하는 동작: 입력칸 아래에 ‘내용을 입력해 주세요’가 보인다. 범위: 폼 컴포넌트와 관련 테스트만 수정. 금지: 패키지 추가, API 변경, 배포.확인다른 사람이 같은 절차로 문제를 다시 볼 수 있어야 합니다. - STEP 2
수정 전에 조사만 요청하기
에이전트에게 아직 파일을 바꾸지 말고 관련 파일, 기존 패턴, 실행할 테스트를 보고하게 합니다.
복사해서 내 상황에 맞게 바꾸세요아직 코드를 수정하지 마. 관련 파일과 데이터 흐름, 비슷한 검증 구현, 실행할 테스트, 예상 위험을 먼저 요약해 줘.확인제안한 수정 파일이 문제 범위와 관련 있고 금지 영역을 건드리지 않는지 봅니다. - STEP 3
작은 범위로 구현시키기
조사 결과를 확인한 뒤 수정 파일과 완료 조건을 다시 지정합니다.
복사해서 내 상황에 맞게 바꾸세요조사한 범위에서 최소 변경으로 구현해 줘. 기존 오류 표시 방식과 스타일을 재사용하고, 빈 값과 정상 값 테스트를 추가해. 관련 없는 정리는 하지 마.확인변경 파일 목록에 예상하지 못한 설정·의존성 파일이 없다면 다음 단계로 갑니다. - STEP 4
테스트 결과와 diff 검토하기
실행한 명령, 성공·실패 결과, 전체 변경 요약을 요구합니다. 직접 diff를 열어 삭제된 코드와 예외 처리를 봅니다.
복사해서 내 상황에 맞게 바꾸세요실행한 테스트와 결과를 그대로 보고하고, 변경 파일별 이유를 설명해. 실행하지 못한 검증은 성공한 것처럼 말하지 말고 별도로 표시해.확인테스트가 통과하고 요구하지 않은 변경이 없으며 오류 상황이 처리되면 완료입니다.
바로 쓰는 양식
한 번에 복사하기
아래 내용을 메모장이나 AI 대화창에 붙여 넣고 빈칸을 채우세요.
문제 재현 절차:
현재 결과:
원하는 결과:
수정 허용 영역:
수정 금지 영역:
완료 조건:
실행할 테스트:
사람이 승인할 작업:자주 막히는 부분
이럴 때는 이렇게 해결하세요
에이전트가 너무 많은 파일을 바꿉니다.
중단하고 수정 허용 파일을 좁혀 다시 요청합니다. 기능 수정과 코드 정리를 같은 작업에 섞지 않습니다.
테스트가 없는데 완료했다고 합니다.
직접 재현 절차를 실행하고 최소 한 개의 회귀 테스트를 추가하게 합니다. 실행하지 못한 검증은 미완료로 둡니다.
패키지나 설정을 임의로 바꿉니다.
패키지 추가와 설정 변경은 사전 승인 대상으로 명시하고 diff에서 잠금 파일 변경을 확인합니다.
마지막 확인
여기까지 확인하면 완료입니다
- 문제를 재현할 수 있다
- 수정 허용·금지 범위를 적었다
- 코드 수정 전 조사 결과를 읽었다
- 테스트 명령과 실제 결과를 확인했다
- 전체 diff에서 불필요한 변경이 없는지 봤다
항상 지킬 안전 규칙
- 비밀키와 운영 데이터는 에이전트 작업 공간에서 분리합니다.
- 삭제·배포·마이그레이션은 승인 지점을 둡니다.
- 테스트가 없는 성공 보고를 그대로 신뢰하지 않습니다.
더 확인하고 싶을 때
기능과 정책은 바뀔 수 있어 공식 자료를 함께 확인했습니다.
Anthropic: Claude Code best practices OpenAI Codex prompting guide