AI 코딩 지시 잘 하는 법 2026 — 아이디어 대신 판단 기준을 주는 이유

"가계부 앱 만들어줘"처럼 아이디어만 주면 결과물은 나옵니다. 화면도 있고 기능도 있습니다. 그런데 열어보면 생각한 것과 다릅니다. 기능이 너무 많거나, 정작 필요한 하나가 없거나, 어디까지가 완성인지 알 수 없는 상태로 끝나 있는 경우가 많습니다. AI가 잘못한 것이 아니라, 방향만 주고 나머지 결정을 전부 AI에게 넘긴 결과입니다.

무엇을 만드는지 한 줄로 정의합니다. 구체적일수록 좋습니다. 왜 만드는지 적습니다. 이유가 명확하면 나중에 기능을 넣을지 말지 판단하는 기준이 됩니다. 어떻게 쓸 것인지 제약을 적습니다. 혼자 쓸 것인지, 어떤 환경에서 볼 것인지 같은 것입니다. 마지막으로 어디까지가 완성인지, "이게 되면 끝"이라고 말할 수 있는 상태를 문장으로 남겨둡니다. 네 가지를 적는 데 보통 십 분이면 충분하지만, 이 십 분이 없으면 며칠을 다시 만들게 됩니다.

Claude Code 공식 문서도 비슷한 순서를 권합니다. 코드를 곧바로 쓰게 하지 말고 탐색과 계획을 실행과 분리하라고 안내하며, 무엇을 바꿀지 먼저 정리하는 플랜 모드를 별도로 제공합니다. 지시문에 완료 기준을 같이 적으라고도 권하는데, 함수 하나를 요청할 때도 통과해야 할 예시 조건을 같이 적으면 결과를 검증할 기준이 생긴다고 설명합니다.

예를 들어 "이메일 주소를 검사하는 함수를 만들어줘"라고만 하면 완성 여부를 판단할 기준이 없습니다. 반면 "user@example.com은 통과, invalid는 실패, user@.com은 실패로 처리하는 validateEmail 함수를 만들고 구현한 뒤 테스트를 돌려줘"처럼 적으면, AI도 스스로 결과를 확인하고 사람도 같은 기준으로 결과를 검토할 수 있습니다. 판단 기준을 정한다는 것은 결국 이런 식으로 통과와 실패를 가르는 구체적인 조건을 미리 문장으로 옮겨두는 일입니다.

여기에 항목을 하나 더 붙이면 도움이 됩니다. 이번에는 만들지 않을 것입니다. 만들다 보면 기능이 계속 떠오르는데, 그때마다 넣으면 범위가 조용히 넓어지고 어느 순간 끝이 안 보이게 됩니다. 시작할 때 안 만들 것을 적어두면 그 목록이 브레이크가 되어 줍니다. 떠오른 아이디어는 지우지 말고 "나중" 칸으로 옮겨두면 됩니다.

"완성된 앱을 만들어줘"처럼 큰 요청은 거의 실패합니다. 대신 기능 하나, 완료 기준 세 개, 하지 말 것 세 개로 나눠서 요청하는 편이 훨씬 잘 됩니다. 기능 하나만 시키고, 그게 됐다고 말할 수 있는 조건을 세 개 적고, 이번에 건드리지 말 것을 세 개 적으면 다시 만드는 횟수가 눈에 띄게 줄어듭니다. 검수를 시킬 때도 마찬가지입니다. "확인해줘"라고만 하면 AI가 알아서 고쳐버리는 경우가 많으므로, "아직 수정하지 말고 문제를 심각한 순서대로 보고만 해줘"처럼 구체적으로 요청하면 고칠지 말지를 직접 정할 수 있습니다.

판단 기준을 미리 적는 일은 번거로워 보이지만, 실제로 시간을 잡아먹는 쪽은 반대입니다. 기준 없이 시작하면 결과물이 나온 뒤에야 무엇이 빠졌는지 알게 되고, 그 시점에서 고치는 비용은 시작 전에 적는 비용보다 훨씬 큽니다. 그리고 이 네 가지는 한 번 적어두면 끝이 아니라 프로젝트가 진행되는 동안 계속 참고할 기준점이 됩니다. 처음 며칠은 기준을 적는 습관 자체가 어색하지만, 결과물을 다시 만드는 횟수가 줄어드는 것을 실제로 체감하고 나면 이 절차를 건너뛰기가 오히려 불안해집니다.

기획서를 꼭 문서로 써야 하나요?

문서 형식일 필요는 없습니다. 위의 네 가지를 메모장에 적은 다섯 줄이면 충분합니다. 중요한 것은 형식이 아니라 시작 전에 결정을 내려두는 것입니다.

완료 기준을 못 정하겠으면 어떻게 하나요?

"이게 화면에 보이면 끝"처럼 눈으로 확인 가능한 것으로 적으면 됩니다. 확인 방법이 떠오르지 않는 완료 기준은 대체로 아직 결정되지 않은 것입니다.

AI가 정해준 기준을 자꾸 무시하면 어떻게 하나요?

기준이 대화 안에만 있어서 그럴 가능성이 큽니다. 반복되는 기준은 대화가 아니라 파일로 적어두면 매번 다시 읽히므로 훨씬 잘 지켜집니다.

AI에게 넘길 것은 구현이고, 사람이 쥐고 있어야 할 것은 판단입니다. 아이디어만 주지 말고 무엇을·왜·어떻게·어디까지를 먼저 정리하면 결과물이 원하는 것에 훨씬 가까워집니다. 판단 기준은 한 번 적어두면 프로젝트가 끝날 때까지 재사용할 수 있는 자산이 되므로, 처음 작성에 들인 십 분은 결코 낭비되지 않습니다. 정확한 기능과 옵션은 아래 공식 문서에서 확인하는 것이 가장 안전합니다.

• Anthropic — Best practices for Claude Code (https://code.claude.com/docs/en/best-practices, 확인일 2026-09-18)