AI 협업 플레이북
워크플로는 '어떤 단계를 밟을지'를, 이 페이지는 'AI와 어떻게 협업할지'를 알려줍니다 — 지시하기, 산출물 검토, 개입 시점, 막혔을 때 복구. 이것들을 습관으로 만들면 AI는 든든한 동료가 됩니다.
AI 코딩 흐름으로 돌아가기 →지시하기
어떻게 맡겨야 AI가 정확히 받는가.
한 번에 한 가지만 맡긴다
왜：여러 가지를 동시에 다루면 AI는 일부를 놓치고, 어디가 잘못됐는지도 알기 어렵다.
이렇게
「우선 로그인 화면만, 나머지는 그대로」. 끝나면 다음을 맡긴다.
이렇게 말고
「로그인·결제·관리자 화면을 한꺼번에 다 만들어」.
배경과 제약을 분명히 말한다
왜：AI는 당신 머릿속 전제를 볼 수 없다; 배경이 없으면 추측할 뿐이다.
이렇게
대상 사용자·연동할 서비스·쓰면 안 되는 것을 알려준 뒤 시작하게 한다.
이렇게 말고
「장바구니 만들어」 한마디만 던지고 나머지는 알아서 하길 바란다.
「완료」가 어떤 모습인지 먼저 정한다
왜：완료 기준이 없으면, 당신이 아직 멀었다 여길 때 AI는 「됐다」고 한다.
이렇게
「완료 = 가입 가능, 로그인 가능, 비밀번호 틀리면 경고 표시」.
이렇게 말고
「대충 되면 돼」 같은 경계 없는 지시.
검토하기
AI 산출물을 믿기 전에 어떻게 확인하는가.
이해 못 한 건 받지 않는다
왜：이해 못 한 코드를 받는 것은 미래의 유지보수 비용에 조용히 서명하는 것과 같다.
이렇게
당신 말로 다시 설명할 수 있을 때까지 AI에게 단락별로 설명하게 한다.
이렇게 말고
작동하니까 통째로 붙여넣고 바로 다음으로.
산출물을 요건과 대조한다
왜：작동한다는 것이 당신이 요청한 일을 한다는 증거는 아니다.
이렇게
만들어진 것을 기능 목록에 하나씩 대조해 빠지거나 더한 게 없는지 확인한다.
이렇게 말고
화면이 작동하는 걸 보고 완료로 치고, 요건으로 되돌아가지 않는다.
개입하기
언제 손을 대어 궤도를 되돌리는가.
제자리를 돌면 멈춘다
왜：같은 오류를 맴돌 때, 더 재촉하면 더 오래·더 지저분하게 돈다.
이렇게
일단 멈추고 문제를 다시 말하거나 다른 각도로 설명한다.
이렇게 말고
「아직 틀려, 다시 해」만 반복하며 스스로 빠져나오길 기대한다.
「됐다」면 증명을 요구한다
왜：「아마 될 거예요」는 증거가 아니다; 검증 없는 「완료」는 대개 반제품이다.
이렇게
「실제로 된다는 걸 증명할 단계나 테스트를 줘」.
이렇게 말고
「완료됐다」는 말에 바로 배포하거나 전달한다.
복구하기
잘못됐을 때 어떻게 되돌리는가.
막히면 작업을 더 잘게
왜：대부분의 정체는 한 단계가 너무 많은 일을 하려 해서다; 잘게 나누면 보통 즉시 풀린다.
이렇게
큰 작업을 각자 완료되는 두세 개의 더 작은 단계로 나눈다.
이렇게 말고
같은 큰 작업을 반복해 다시 설명하며 이번엔 다르길 기대한다.
정말 어긋나면 대화를 새로
왜：대화가 길어지고 맥락이 오염되면 AI는 낡은 잘못된 전제를 붙든다.
이렇게
새 대화를 열고 「현재 코드 + 분명한 목표」만 들고 다시 시작한다.
이렇게 말고
이미 엉킨 대화 안에서 끝없이 땜질한다.