긴 개발 지시서를 실행 순서와 완료 조건으로 바꾸기
2026.10.19

소개
긴 요청을 한 번에 완료했다고 말하지 않기
저는 AI에게 긴 개발 지시서를 검토하고 구현과 검증을 진행하도록 맡긴 작업을 정리했습니다. 지시서에는 조사할 내용, 만들 동작, 확인할 조건, 외부 승인이 필요한 단계가 함께 들어 있었습니다. 이때 중요한 일은 문장을 빠짐없이 옮기는 것보다, 어떤 순서로 실행하고 어디서 멈춰야 하는지 구분하는 것이었습니다.
이 글에서는 실제 아이디어와 고유한 업무 기준을 제외합니다. AI와 요청을 분해하고, 별도 로컬 시제품을 만들고, 실제 검사와 미완료 조건을 대조한 방식만 다룹니다. 당시 초기 개발 기록을 기준으로 하며, 이후 작업의 결과를 이 단계의 성과처럼 섞지 않았습니다.
이 작업에서 구분해야 할 점은 한 가지였습니다. 화면과 코드가 생겼다는 이유로 긴 지시서 전체가 끝났다고 말하는 것입니다. 내부에서 실행되는 기능, 합성 입력으로 확인한 동작, 외부 제공자의 실제 응답이 필요한 부분은 같은 완료 상태가 아니었습니다.
설명용 일러스트, 실제 앱 화면 아님: 길고 복잡한 요청은 실행과 검증의 순서를 가리기 쉽다.
진행 방법
아이디어를 제외한 요청 요약
아래는 실제 요청의 원문이 아닙니다. 보호할 기획 내용과 판단 규칙을 제외하고, 진행 방식에 해당하는 부분만 정리한 요약입니다.
아이디어를 제외한 요청 요약
긴 개발 지시서를 검토해 실행 가능한 작업으로 나눠 주세요.
각 작업의 완료 조건과 확인 근거를 연결해 주세요.
되돌릴 수 있는 로컬 시제품을 만들고 실제 실행으로 검사해 주세요.
외부 연결과 별도 승인이 필요한 일은 완료로 처리하지 말아 주세요.저는 이 요청을 '전체를 만들어 달라'는 한 문장으로 취급하지 않았습니다. 조사와 구현, 검수, 외부 행동의 성격이 다르기 때문입니다. 각각 결과를 무엇으로 확인할 것인지 적어 두어야, 진행 중에 범위가 늘어나거나 어려운 부분이 조용히 빠지는 일을 발견할 수 있습니다.
요구사항마다 확인할 모습을 붙이기
당시에는 요구사항 추적 문서에 원문 위치와 관찰 가능한 완료 기준, 현재 결과와 남은 공백을 연결했습니다. 저는 이를 지시서를 다시 쓰는 목록이 아니라, 요청에서 결과까지 이어지는 연결 고리로 보았습니다. 구현 파일이 있다는 말만으로 충분하지 않은 항목을 드러내는 역할이었습니다.
설명을 위한 일반 예시로, '문서 작업이 가능해야 한다'는 요청은 너무 넓습니다. '항목을 추가하고 다시 열었을 때 남아 있는가'와 '잘못된 입력은 거절되는가'로 나누면 확인할 행동이 보입니다. 이 예시는 실제 시제품의 기능이나 고유 기준을 재현한 것이 아닙니다.
또한 조사한 사실과 사용할 권한을 분리했습니다. 일반 문서를 읽었다는 사실은 실제 외부 연결을 해도 된다는 승인과 다릅니다. 저는 조사 결과를 구현 완료로 올리지 않고, 아직 응답이나 허락이 필요한 작업 옆에 공백으로 남기는 방식에 주목했습니다.
먼저 되돌릴 수 있는 범위에서 만들기
초기 결과는 로컬에서 실행하는 시제품이었습니다. 기존의 다른 작업과 전역 설정을 바꾸지 않고 별도 작업 범위 안에 구현과 문서를 남겼습니다. 외부 유료 실행과 발송, 공개 배포처럼 되돌리기 어렵거나 추가 승인이 필요한 행동은 내부 구현과 분리했습니다.
로컬이라는 말이 단순한 그림을 뜻하지는 않았습니다. 당시 기록에는 실제 HTTP 요청, 디스크 저장과 다시 열기, 별도 작업 프로세스의 실행을 확인한 내용이 남아 있습니다. 다만 검사에 들어간 업무 내용은 합성이었습니다. 저는 실행 수단이 실제라는 사실과 입력 내용이 실제라는 사실을 혼동하지 않았습니다.
이 구분은 결과를 과장하지 않으면서도 구현한 범위를 설명하는 데 도움이 됐습니다. '전부 가짜였다'고 말하면 실제 저장과 오류 처리 검사를 지워 버리고, '실제 실행됐다'고만 말하면 외부 자료까지 연결됐다고 오해할 수 있습니다. 실행과 자료의 성격을 각각 적는 방식이 필요했습니다.
구현 순서를 검증 가능성에 맞추기
긴 지시서는 앞에서부터 순서대로 끝내기만 하면 되는 문서가 아니었습니다. 기반이 되는 저장과 실행을 확인하고, 그 위에서 대표적인 사용자 흐름을 점검하며, 외부 연결이 필요한 부분은 비활성 경계로 남겼습니다. 저는 이 과정에서 작업 단위마다 확인 근거가 달라진다는 점을 정리했습니다.
설명을 위한 일반 예시로, 항목을 기록하는 작업은 화면에 글자가 나타나는 것만으로 끝나지 않습니다. 저장 응답, 다시 열었을 때의 상태, 잘못된 입력에 대한 반응을 나눠 볼 수 있습니다. 반면 외부 시스템에 전달하는 작업이라면 내부 기록만 남았다는 사실은 상대가 받았다는 증거가 아닙니다.
위 예시는 설명을 위한 일반 예시이며, 원래 시제품의 실제 조작이나 처리 규칙을 옮긴 것이 아닙니다. 제가 남기려는 것은 특정 기능의 조합이 아니라, 기능별로 필요한 근거가 다르다는 작업 방식입니다.

설명용 일러스트, 실제 앱 화면 아님: 요청을 작업 카드와 검증 순서로 나눈다.
자동 검사와 브라우저 확인을 연결하기
당시 검증은 정적 검사와 빌드(실행 전에 코드를 점검하고 묶는 과정)에서 끝나지 않았습니다. 로컬 서버에 실제 요청을 보내고, 자료를 다시 열고, 별도 작업 프로세스가 동작하는지 확인했습니다. 브라우저에서도 대표 흐름을 실행하고, 내부 경로를 직접 열거나 새로고침한 상태를 점검했습니다.
화면 검수에서는 넓고 좁은 여러 폭에서 가로 넘침을 확인했습니다. 하지만 이를 실제 휴대기기와 운영체제별 동작까지 검증한 것으로 설명하지 않았습니다. 화면 크기 대응, 물리 기기 조작, 장시간 운영은 서로 다른 검사라는 점을 유지했습니다.
문서에서는 검수 결과와 완료 조건을 대조할 수 있게 정리했습니다. 자동 검사에 통과한 항목이라도 합성 입력을 사용했다면 그 한계를 그대로 붙였습니다. 로컬 서버가 새 요청에 응답한 사실도 컴퓨터를 끈 뒤 계속 운영된다는 증거로 확대하지 않았습니다.
지적된 문제와 재현되지 않은 의심을 구분하기
독립 재검토에서 지적된 문제는 수정과 회귀 확인으로 연결됐습니다. 반대로 의심이 제기됐지만 실행 검사에서 재현되지 않은 항목도 기록에 남아 있었습니다. 저는 검토 의견이 있다는 이유로 결함을 확정하거나, 수정했다는 말만으로 검증을 끝내지 않는 점을 중요하게 보았습니다.
이번 글에서는 그 문제들의 실제 업무 맥락을 공개하지 않습니다. 대신 문제 제기, 재현 여부 확인, 수정, 다시 검사라는 순서를 남깁니다. AI의 검토를 또 다른 정답으로 받기보다, 실행 근거와 비교할 판단 자료로 사용하는 방식입니다.
외부 연결은 별도 완료 조건으로 남기기
내부에서 준비된 연결 구조와 외부 시스템이 실제로 응답한 상태는 다릅니다. 당시 추적 문서에도 권한과 설정, 실제 응답과 수신, 지속 실행이 필요한 항목은 미완료 또는 차단으로 남아 있었습니다. 저는 이 빈칸을 없애기 위해 추정 결과를 채워 넣지 않았습니다.
다음 단계가 외부 행동이라면 대상과 전송 범위, 비용과 권한을 확인한 뒤 별도 승인해야 합니다. 개발을 시작하라는 요청이 외부 발송이나 공개 운영까지 허용하는 것은 아닙니다. 추천하는 다음 작업을 제시하는 일과 실제로 실행하는 일도 구분했습니다.
결과와 배운 점
완료한 것과 남은 것을 같은 문서에서 보기
당시 기록 기준으로 로컬 시제품의 실행과 저장, 대표 브라우저 흐름, 정적 검사와 빌드를 확인했습니다. 동시에 실제 외부 연결과 수신, 지속 운영, 공개 준비는 끝나지 않았습니다. 저는 이 글을 쓰며 다시 실행한 것은 아니며, 초기 검증 문서의 보고 범위 안에서만 결과를 설명합니다.
이 과정을 통해 제가 얻은 것은 긴 요청을 한 번에 완료했다는 선언이 아니었습니다. 무엇을 만들었고 무엇으로 확인했는지, 다음 행동 전에 무엇이 필요한지 연결된 작업 기록이었습니다. 요구사항 추적은 빈칸을 숨기지 않고 다음 판단의 위치를 보여 주는 데 의미가 있었습니다.
다음 지시서에서 먼저 적을 내용
앞으로 비슷한 요청을 한다면 저는 구현할 일과 확인할 일, 별도 승인이 필요한 일을 처음부터 나누겠습니다. 완료 기준에는 결과물의 존재뿐 아니라 실제 실행에서 볼 상태를 적고, 합성 검사와 실제 연동 검사를 서로 바꾸어 쓰지 않겠습니다.
AI가 많은 작업을 수행하더라도 마지막 판단은 근거의 종류를 구분하는 데 달려 있었습니다. 로컬에서 확인한 것을 외부 완료로 올리지 않고, 아직 필요한 권한과 응답을 남겨 두는 것. 이번 작업에서 제가 가장 분명히 배운 진행 원칙입니다.

설명용 일러스트, 실제 앱 화면 아님: 완료와 보류, 사람 확인을 서로 다른 상태로 남긴다.
도움 받은 글 (옵션)
당시 작업 기록, 요구사항 추적 문서와 검증 요약을 바탕으로 작성했습니다. 실제 지시서 원문과 기획 자료는 공개하지 않습니다. 본문 이미지는 방법을 설명하기 위해 제작한 일러스트이며, 구현 결과나 외부 연결 성공을 증명하는 실제 화면이 아닙니다.
로그인하고 댓글을 남겨 주세요
긴 지시서의 원문 위치마다 관찰 가능한 완료 기준과 현재 결과, 남은 공백을 연결하신 방식이 유용해요. 앞선 글들에서 보았던 완료·보류 구분을 초기 개발 기록으로 돌아가 설명해주셔서, 그 판단이 어떤 요청에서 시작됐는지 읽을 수 있었습니다. 나중 작업의 결과를 이 단계의 성과에 섞지 않았다는 설명도 있어, 여러 기록을 함께 읽을 때 시점을 혼동하지 않게 되고요.
합성 입력을 썼지만 HTTP 요청과 디스크 저장·다시 열기, 별도 프로세스 실행은 실제로 확인했다는 구분이 중요하게 다가왔습니다. 합성 자료를 썼다는 이유로 구현한 동작까지 없던 일이 되는 것은 아니고, 실제로 실행됐다는 이유로 외부 연동도 끝난 것은 아니니까요. 내부 경로 직접 열기와 새로고침, 여러 화면 폭의 확인도 당시 검사에 포함하되 물리 기기나 지속 운영의 근거로 넓히지 않으셨네요.
독립 재검토의 지적을 다룬 과정에서도 진태님의 판단이 보입니다. 지적된 문제는 수정 후 다시 확인하고, 실행에서 재현되지 않은 의심은 확정된 결함과 분리해두셨어요. 에이전트의 검토 의견 역시 실행 결과와 대조할 자료로 다루신 것이죠. 문서를 조사한 사실과 실제 연결을 사용할 권한을 나누고, 외부 응답·수신·지속 실행에 필요한 공백을 그대로 둔 점도 이 작업의 완료 기준을 이해하는 데 도움이 됩니다.
요청을 잘게 나누는 데서 끝내지 않고 각 결과를 무엇으로 확인했는지 연결해주신 수고가 글에 남아 있어요. 구현된 부분은 인정하면서 승인과 응답이 남은 부분도 같은 문서에서 볼 수 있게 하셨습니다. 긴 개발 요청을 맡긴 사람이 마지막 완료 보고를 어떤 근거로 읽어야 하는지 보여주셔서 고맙습니다.

강진태님, 긴 지시서를 순서대로 끝내기만 하는 문서로 보지 않고 작업마다 필요한 확인 근거가 다르다고 정리하신 점이 인상적이었어요.
"실행 수단이 실제라는 것"과 "입력 내용이 실제라는 것"을 구분해 적으신 부분, 그리고 외부 연결처럼 아직 허락이 필요한 일을 구현 완료에 섞지 않고 빈칸으로 남기신 부분이 특히 좋았어요. 검토에서 지적된 문제와 재현되지 않은 의심을 따로 기록한 것도 따라 해보고 싶은 방식이에요.
오 이 부분 진짜 재밌어요 👀