AI 에이전트에게 코드를 맡기기 전에, 작업에 체크포인트를 넣으세요

Larry

동료에게 코드 수정을 부탁할 때 보통은 issue를 쓰고, 요구사항을 보완하고, branch를 만들고, 마지막에 pull request를 봅니다. 중간에 여러 번 오가더라도, 요청이 타당한지, 어디를 바꿔야 하는지, 언제 merge해도 되는지는 사람이 판단합니다.

Coding agent가 바꾸는 것은 이 일상적인 장면입니다. 코드를 제안하는 데서 끝나지 않고, issue를 읽고, 파일을 수정하고, 테스트를 실행하고, 스스로 pull request까지 열 수 있습니다. AI가 “채팅에서 조언하는 도구”에서 “repo 안에서 실제로 손을 대는 도구”로 이동하는 것입니다.

편리하지만 제품 판단까지 책임지지는 않습니다. 범위, 가정, 위험, rollback은 사람이 먼저 경계를 정해야 합니다. Devin, Copilot 형태의 coding agent, 비슷한 도구를 도입하기 전에 “혼자 끝낼 수 있을까?”만 묻지 마세요. 어느 지점에서 멈춰야 사람이 방향이 맞는지 확인할 수 있는지부터 정하세요.

이 글은 “AI 에이전트에게 코드를 맡기기 전에, 작업에 체크포인트를 넣으세요”를 독자가 바로 쓸 수 있는 하나의 판단 문제로 좁힌다. coding agent는 issue를 읽고, 파일을 수정하고, 테스트를 실행하고, PR까지 열 수 있습니다. 하지만 작업을 단 한 줄로 넘겨서는 안 됩니다. 어디까지 진행해도 되는지, 어디서 사람이 확인해야 하는지 먼저 정하세요. 아래 표와 체크리스트는 팀이 진행하기 전에 무엇을 정하는 것에 쓰면 된다.

먼저 체크포인트 표로 시작하기

작업이 모호할수록 한 번에 agent에게 넘기면 안 됩니다. 먼저 검수 가능한 단계로 나누세요.

체크포인트	Agent가 할 수 있는 일	사람이 확인할 일	통과하지 못하면
작업 요약	issue, 목표, 제외 범위를 다시 설명	잘못된 제품 가정을 추가하지 않았는가	prompt를 고치거나 issue를 줄임
구현 계획	바꿀 파일, 함수, 테스트를 나열	범위가 너무 넓거나 민감한 흐름을 건드리는가	다시 계획하게 함
첫 작은 diff	테스트나 명확한 모듈 하나만 변경	diff가 읽기 쉽고 되돌리기 쉬운가	범위가 커지기 전에 멈춤
테스트와 증거	지정 테스트를 실행하고 결과를 제시	CI 통과뿐 아니라 요구사항을 증명하는가	테스트나 인수 조건을 추가
PR 리뷰	가정, 제한, rollback을 설명	데이터, 권한, API, 사용자 흐름 가정이 맞는가	PR을 나누거나 사람이 이어받음

이 표의 목적은 절차를 늘리는 것이 아니라, agent가 틀린 방향으로 더 많은 일을 하게 되는 것을 막는 것입니다.

바로 맡기기 vs 체크포인트 흐름

명확한 issue 템플릿, 테스트 습관, review gate가 없다면 coding agent는 그 빈틈을 더 크게 만듭니다.

범위: 바로 맡기면 agent가 파일과 제품 가정을 추측합니다. 체크포인트 흐름은 사람이 목표, 제외 범위, 건드리면 안 되는 영역을 먼저 정합니다.
Diff와 테스트: 바로 맡기면 테스트, 로직, UI, 문서, 설정이 한 번에 바뀔 수 있습니다. 체크포인트 흐름은 diff를 작게 유지하고 지정한 동작의 증거를 요구합니다.
Rollback: 바로 맡기면 PR이 커진 뒤에야 위험을 볼 수 있습니다. 체크포인트 흐름은 각 단계에서 멈추고, 되돌리고, 나눌 수 있게 합니다.

작업이 명확하고, 테스트가 있으며, 변경 범위가 작다면 agent는 좋은 가속기가 됩니다. 요구사항이 아직 논의 중이고, 핵심 흐름에 테스트가 없고, 비즈니스 규칙을 아무도 설명하지 못한다면 전체 구현을 바로 맡기지 마세요.

어떤 작업을 agent에게 맡길까

Cognition의 Devin과 다른 coding agents는 “AI가 스스로 PR을 연다”는 일을 익숙하게 만들었습니다. 그래도 실무 기준은 단순합니다. 이 작업은 검수할 수 있는가?

적합: 완료 조건, 제외 범위, 관련 파일, 지정 테스트, 제한된 위험, review 담당자, 작은 PR 또는 feature flag 기반 rollback 경로가 있는 issue.

아직 부적합: 모호한 기능 요청, 테스트 없는 핵심 흐름, 결제, 권한, 삭제, 로그인, 또는 검증과 복구 방법이 불명확한 여러 서비스 변경.

전환하지 않을 경우: 적합 조건의 절반도 만족하지 못한다면 기능 전체를 agent에게 넘기지 마세요. 코드베이스 조사, 계획 작성, 테스트 초안, 의존 파일 찾기에 쓰고, 사람이 확인한 뒤 작은 diff만 허용하세요.

Coding agent는 생산량을 높일 수 있지만 제품 책임을 대신 지지 않습니다. PR이 너무 커진 뒤에 보는 대신, 처음부터 작업 안에 사람의 체크포인트를 넣어 두세요.

생활 4컷 만화

친구가 수납장을 조립하기 전에 위치, 치수, 확인 지점을 정하는 4컷 만화

누군가에게 바로 수납장을 조립해 달라고 하지만, 처음에 치수와 위치, 완료 기준을 확인하지 않았습니다.
중간에 크기가 맞지 않거나 방향이 틀렸다는 걸 알면, 먼저 확인하는 것보다 다시 하는 일이 더 큽니다.
치수, 단계, 체크포인트, 되돌리는 방법을 먼저 정리하면 작업은 안정적으로 끝납니다.
coding agent도 같습니다. AI에게 코드를 쓰게 하기 전에 사람의 체크포인트, 테스트, rollback을 정하세요.

AI 정리 카드

이 글의 판단을 내 체크리스트로 바꾸기 이것은 요약 프롬프트가 아니다. 글의 방법을 내 워크플로, 제약, 데이터, 의사결정 목표에 맞춰 되돌리는 지시문이다.

이 BMC 미니 레슨을 내 상황에 적용하고 싶다: AI 에이전트에게 코드를 맡기기 전에, 작업에 체크포인트를 넣으세요

이 글이 다루는 구체적인 문제: coding agent는 issue를 읽고, 파일을 수정하고, 테스트를 실행하고, PR까지 열 수 있습니다. 하지만 작업을 단 한 줄로 넘겨서는 안 됩니다. 어디까지 진행해도 되는지, 어디서 사람이 확인해야 하는지 먼저 정하세요.
글 URL: https://boosterminiclass.com/ko/posts/coding-agents-need-human-checkpoints/

글을 요약만 하지 말아 달라. 먼저 다음 3가지를 확인하는 질문을 해 달라.
1. 내가 지금 다루는 실제 워크플로 또는 의사결정은 무엇인가.
2. 이 흐름에 어떤 데이터, 권한, 계정, 비용, 외부 실행이 관련되는가.
3. 오늘 필요한 결과가 중단/진행 판단, 시험 도입 체크리스트, 인수인계 템플릿, 위험 등급 중 무엇인가.

그다음 이 글의 프레임워크로 내 상황을 점검해 달라: 1. coding agent에게 맡길 작업 범위, 비목표, 건드리면 안 되는 파일·시스템; 2. issue 읽기, 파일 수정, 테스트 실행, PR 생성 중 어디까지 맡길지; 3. 어떤 diff, 오류, 권한, 데이터 변경에서 사람 검토로 멈출지; 4. 지시문, 테스트, rollback, review 인계 체크리스트.

다음 형식으로 출력해 달라:
- 지금 바로 진행, 제한적으로 시험, 일단 중단 중 무엇인지 한 문장 판단;
- 프레임워크를 내 상황에 적용한 표: 준비됨 / 근거 부족 / 사람 확인 필요;
- 오늘 할 수 있는 가장 작은 한 단계;
- 담당자, 로그, 되돌리기, 사람 검토가 필요한 지점.