기획을 정리하는 대화와 실제 파일을 수정하는 작업을 나누면 역할이 선명해질 수 있다. 하지만 다음 작업자가 긴 대화만 전달받으면 어느 계획이 구현되었고 어떤 오류가 아직 남았는지 다시 찾아야 한다.
인계의 목적은 이전 대화를 그대로 재생하는 것이 아니다. 현재 결과물과 근거를 기준으로 다음 행동을 결정할 수 있게 만드는 것이다.
좋은 인계에는 원하는 결과뿐 아니라 지금 존재하는 결과와 아직 확인하지 못한 부분이 함께 들어 있다.
1. 제품 이름보다 맡길 일과 확인 방법을 정한다
요구사항 정리, 설계, 파일 수정과 검증은 서로 다른 작업이다. 어떤 AI 도구가 항상 생각을 더 잘하거나 항상 실행 비용이 낮다고 고정하지 않고, 실제 접근 권한과 작업에 필요한 자료로 역할을 배분한다.
NIST의 인간·AI 상호작용 설명은 역할과 맥락을 구분하는 문제를 다룬다. 프로젝트에서도 제안할 수 있는 일, 직접 바꿀 수 있는 일과 최종 판단할 일을 명시하면 결과를 평가하기 쉬워진다.
2. 완료 조건에 관찰할 결과를 적는다
검색 화면을 만든다는 요구에는 입력·결과·빈 상태·오류 상태 등이 들어 있을 수 있다. 멋지게 또는 잘 되게라는 표현만으로는 구현자가 무엇을 확인해야 하는지 알기 어렵다.
목표와 사용 상황, 범위, 실패했을 때의 동작과 확인할 기준을 함께 쓴다. 기존 코드·디자인·데이터가 있다면 원본 경로와 사용할 버전도 표시한다. 작업지시서에는 새로 만들 것만큼 먼저 재사용할 자료의 근거가 필요하다.
3. 제안한 계획과 실제 변경을 나누어 전달한다
인계 항목 | 다음 작업자가 알아야 할 내용 |
|---|---|
목표와 범위 | 원하는 결과, 이번에 다룰 부분 |
현재 결과물 | 기준 파일·버전과 실제 변경 |
확인 근거 | 실행한 검사와 결과, 관찰한 동작 |
남은 문제 | 재현 조건과 아직 확인하지 못한 부분 |
다음 행동 | 먼저 조사하거나 수정할 구체적인 대상 |
AI가 고쳤다고 말한 기록과 실제 저장된 파일은 다를 수 있다. 변경 설명에 파일과 실행 결과를 연결하고, 계획만 작성한 단계라면 그대로 표시한다. 이전 대화의 요청도 현재의 실행 범위로 무조건 승계하지 않는다.
파일을 실제로 읽을 수 있는 AI에는 이렇게 요청할 수 있다. “현재 검색 화면 파일과 검사 결과를 읽고, 구현된 기능·실행해 확인한 동작·아직 확인하지 못한 동작을 나누어 적어라. 각 항목에 파일 경로 또는 검사 기록을 붙여라. 계획만으로 완료라고 쓰지 마라.” 출력의 한 행은 빈 검색어 처리 / 안내 문구 구현 / 화면 실행은 미확인 / 관련 파일 경로처럼 만든다. 다음 작업자는 해당 파일과 화면을 대조한다. 파일 접근이나 검사 기록이 없으면 확인 불가로 남긴다.
4. 오류를 전달할 때 판단의 재료도 보낸다
오류 메시지만 복사하기보다 어떤 입력·명령·환경에서 발생했는지, 기대한 결과와 실제 결과가 어떻게 다른지 정리한다. 관련 파일과 변경 직후의 상태를 연결하면 불필요한 추측을 줄일 수 있다.
스크린샷은 화면 문제를 설명하는 근거가 될 수 있지만 모든 원인과 내부 상태를 담지는 않는다. 관찰한 사실과 원인에 대한 추측을 나누어 보내야, 추측을 전제로 같은 수정을 반복하는 일을 줄일 수 있다.
5. 효율은 인계 횟수보다 완료한 작업으로 평가한다
역할을 많이 나누었다는 사실만으로 효율이 높아지지는 않는다. 설명을 다시 만드는 시간, 맥락이 빠져 생긴 재작업, 검토 부담과 실제 비용을 함께 본다.
프로젝트의 핵심 상태 기록을 갱신하고 중요한 결정에는 근거를 남긴다. 다음 대화가 같은 파일과 같은 완료 기준에서 이어질 수 있을 때, AI와의 협업은 반복 설명에서 누적 작업으로 바뀐다.