"AI한테 '절차'를 가르치지 마세요, '스펙 한 장'을 던지세요 — 요구사항서만 잘 써도 코딩 에이전트가 알아서 완성합니다"

"버튼을 왼쪽 위에 만들고, 색은 파란색으로 하고, 클릭하면 모달이 뜨게 하고, 그 모달 안에는…"
혹시 AI한테 이렇게 한 줄 한 줄 지시하다가 지친 적 있으신가요?
— 그렇다면 당신은 AI를 '타이피스트'로 쓰고 있는 겁니다.

많은 분들이 AI 코딩 에이전트를 쓰면서 똑같은 실수를 반복합니다. 바로 '절차(How)'를 가르치려는 것이죠. 마우스를 어디로 옮기고, 어떤 함수를 먼저 쓰고, 어떤 순서로 파일을 만들지를 일일이 불러줍니다. 하지만 이건 계산기에게 덧셈하는 법을 설명하는 것과 같습니다.

진짜 고수들은 정반대로 합니다. '무엇을(What)' 원하는지가 담긴 '스펙 한 장'을 던지고, 절차는 에이전트에게 통째로 위임합니다. 이것이 요즘 개발 현장을 바꾸고 있는 스펙 주도 개발(Spec-Driven Development)입니다.

절차를 가르치는 사람 vs 스펙을 던지는 사람

같은 AI 코딩 에이전트를 써도 결과물의 완성도가 하늘과 땅 차이인 이유가 여기에 있습니다. 두 접근법이 어떻게 다른지 한눈에 비교해 봅시다.

그래서 '스펙 한 장'에는 뭐가 들어가야 할까?

스펙 주도 개발이라고 해서 거창한 기획서가 필요한 게 아닙니다. Claude Code 같은 코딩 에이전트에게 던질 스펙은 딱 5가지 축만 채우면 됩니다. 이걸 문서(예: SPEC.md) 한 장에 정리해 두면, 에이전트가 세션이 바뀌어도 맥락을 잃지 않습니다.

특히 4번 완료 기준이 핵심입니다. 비개발자분들이 가장 많이 빠뜨리는 항목이죠. "로그인하면 할 일 목록이 보이고, 체크하면 줄이 그어진다"처럼 검증 가능한 문장으로 적으면, 에이전트는 그 기준을 통과할 때까지 스스로 고쳐가며 완성합니다.

실제로 이렇게 던지면 됩니다

예를 들어 '동네 반찬가게 주문 받는 앱'을 만든다고 해봅시다. 절차를 가르치는 대신 이렇게 스펙을 던집니다.

이 한 장을 Claude Code에 넣고 "이 스펙대로 만들어줘"라고 하면, 에이전트는 파일 구조 설계 → 화면 구현 → 데이터 저장 → 완료 기준 자가 점검까지 절차 전체를 알아서 밟습니다. 당신은 절차가 아니라 '검수'만 하면 됩니다.

이게 왜 '비개발자 수익화'의 열쇠인가

여기서부터가 진짜 중요합니다. 스펙을 쓰는 능력은 코딩 실력이 아니라 '정리 능력'입니다. 즉, 개발을 몰라도 요구사항을 또렷하게 정리할 줄만 알면 AI 에이전트를 통해 실제 결과물을 뽑아낼 수 있다는 뜻이죠.

외주 시장에서 돈을 버는 사람은 '코드를 잘 짜는 사람'이 아니라 '고객의 모호한 요구를 명확한 스펙으로 번역하는 사람'입니다.
— 그 번역문 한 장이 곧 당신의 납품물이자 자산이 됩니다.

고객은 "주문 받는 거 하나 만들어주세요"라고 말합니다. 당신이 할 일은 그 말을 위의 5축 스펙으로 번역하고, 에이전트에게 던져 완성하고, 검수해서 넘기는 것. 한 번 잘 만든 스펙은 다음 고객에게 90%를 재활용할 수 있으니, 할수록 빨라지고 단가는 올라갑니다.

AI 코딩 시대의 경쟁력은 '타이핑 속도'가 아니라 '요구를 스펙으로 정리하는 힘'으로 완전히 옮겨갔습니다. 절차는 에이전트의 몫, 스펙은 당신의 몫입니다.

혹시 "스펙 쓰는 건 알겠는데, 이걸 어떻게 수익으로 연결하지?"가 막막하다면 — 투더제이(TTJ) 코딩클래스 정규반에서는 바로 이 '스펙 주도 바이브코딩'으로 비개발자가 실제 외주를 받고 납품까지 하는 전 과정을 다룹니다. 요구사항서 한 장으로 시작해, 에이전트에게 위임하고, 돈이 되는 결과물로 만드는 흐름을 차근차근 함께 연습해보세요. 🙂