에이전틱 코딩 프롬프트 5원칙: 한 번에 다 시키면 망한다
에이전틱 코딩의 성패는 프롬프트를 잘게 쪼개 검증 가능하게 시키는 데 달려 있습니다. 안드레이 카파시는 2026년 "한 번에 다 시키면 망한다"며 작은 단위로 점진적으로 시킬 때 에이전트가 일관되게 정확한 코드를 낸다고 말했습니다. 핵심은 다섯 가지 원칙입니다. ASAP은 복붙 가능한 패턴으로 정리합니다.
다섯 원칙
에이전트에게 잘 시키는 법은 5개 원칙으로 압축되고, 순서대로 적용하면 실패율이 떨어집니다.
- 작게 쪼개라 — 한 번에 한 PR 크기의 작업만. 큰 기능은 단계로 나눠 차례로 시킨다.
- 검증 기준을 같이 줘라 — 완료 조건·테스트·예상 출력을 프롬프트에 명시한다.
- 맥락을 먼저 읽혀라 — 관련 파일·규칙을 먼저 읽게 한 뒤 작업을 시작시킨다.
- 한 번에 한 목표 — 여러 의도를 한 프롬프트에 섞지 않는다.
- 검증·반영 루프 — 결과를 테스트로 확인하고, 실패를 다음 프롬프트에 반영한다.
이 다섯이 '한 번에 다 시키기'를 막는 장치입니다.
왜 작게 쪼개야 하나
큰 작업을 한 번에 시키면 에이전트가 검증 없이 멀리 가버립니다. 카파시는 2026년 에이전트가 '도와주지만 지저분한' 단계에서 '일관되게 맞는 코드를 내는' 단계로 넘어갔다고 했지만, 그것은 작은 단위로 시킬 때의 이야기입니다. 한 프롬프트가 너무 크면 중간에 어긋나도 잡을 지점이 없습니다.
복붙 패턴
원칙은 한 줄짜리 프롬프트 골격으로 바꿀 수 있습니다. 다음은 검증을 내장한 패턴입니다.
| 상황 | 프롬프트 골격 |
|---|---|
| 새 기능 | "먼저 X·Y 파일을 읽어라. 그다음 A만 구현하고, B 테스트로 검증해라." |
| 버그 수정 | "이 테스트가 실패한다. 원인을 먼저 설명하고, 최소 수정 후 테스트를 통과시켜라." |
| 리팩터 | "동작을 바꾸지 말고 C만 정리해라. 기존 테스트가 모두 통과해야 한다." |
핵심은 모든 골격에 '검증 기준'이 들어 있다는 점입니다.
정리
에이전틱 코딩 프롬프트의 핵심은 5개 원칙으로, 작게·검증 가능하게로 압축됩니다. 작게 쪼개고, 검증 기준을 같이 주고, 맥락을 먼저 읽히고, 한 번에 한 목표만, 결과를 검증해 반영하면 됩니다. 한 번에 다 시키려는 유혹을 이기는 것이 곧 실력입니다.
출처: Andrej Karpathy, "From Vibe Coding to Agentic Engineering"(Sequoia AI Ascent 2026) 기반 ASAP 정리. 관련: 에이전틱 코딩 전문성 연구(Anthropic, 2026).
AI·테크 이슈,
가장 빠르게
단순 소식을 넘어, 맥락과 구조까지 파고듭니다
Ai Soon As Possible · asapai.co.kr
