본문으로 건너뛰기

AI 인수인계 문서, ‘구현됨’과 ‘확인 필요’를 나누는 작은 실습

현중_Specify

2026.10.09

Specify를 만들고 있습니다. 이번 글은 공개 가이드의 가상 예제로 따라 해보는 실습입니다. 가이드의 RelayDesk 인수인계 접근을 바탕으로, 이 글에서 복사해 쓸 수 있는 작은 입력과 프롬프트를 따로 구성했습니다.

AI로 만든 앱을 다른 사람에게 넘길 때는 “만들어 달라고 한 것”, “코드에 들어 있는 것”, “운영하면서 확인해야 하는 것”이 한 문서에 섞이기 쉽습니다. 인수인계 문장을 그럴듯하게 늘리기 전에 이 세 가지부터 나눠 보겠습니다.

1. 비교할 자료를 작게 고정하기

아래 S1~S3는 이 글을 위해 만든 합성 자료입니다. 가이드 원문이나 실제 저장소의 발췌가 아닙니다. 한 시점에 전달받은 자료라고 가정하고, 이 범위 안에서만 판단합니다. sourceID는 각 근거를 다시 찾기 위해 붙인 표식입니다.

S1 · notes/handover.md

  • 이번 전달 범위는 문의 목록 조회입니다.

  • CSV 내보내기는 다음 작업으로 요청되었습니다.

  • 운영 담당자, 배포 주소, 롤백 절차는 아직 기입하지 않았습니다.

S2 · src/routes/tickets.ts

router.get("/tickets", async (_req, res) => {
  const tickets = await db.ticket.findMany();
  res.json(tickets);
});

S3 · tests/tickets.test.ts

it("returns ticket list", async () => {
  const response = await request(app).get("/tickets");
  expect(response.status).toBe(200);
  expect(Array.isArray(response.body)).toBe(true);
});

S2와 S3는 읽기용 코드 발췌입니다. 실행에 필요한 전체 프로젝트와 테스트 실행 기록은 제공하지 않았습니다.

2. 아래 프롬프트로 검토 요청하기

위 자료와 다음 요청을 함께 AI에 넣어 보세요. 이 연습은 익숙한 AI 채팅에서도 해볼 수 있습니다.

“제공된 S1~S3만 근거로 인수인계 검토 초안을 작성해 주세요.

각 항목을 ① 제공 코드에서 확인되는 내용 ② 문서에 적힌 요구사항 ③ 추가 확인이 필요한 내용으로 나눠 주세요.

항목마다 결론, sourceID와 파일 경로, 근거가 되는 짧은 부분, 확인 범위를 적어 주세요. 요구사항을 구현 완료로 바꾸지 마세요.

코드에 테스트가 정의되어 있는지와 실제 테스트가 통과했는지를 구분해 주세요. 실행 기록이 없으면 통과 여부는 확인 불가로 남겨 주세요.

제공한 발췌에 없는 기능은 ‘제공 범위에서 확인되지 않음’이라고 써 주세요. 저장소 전체에 그 기능이 없다고 단정하지 마세요.

운영 담당자, 배포 주소, 롤백 절차를 추측해서 채우지 마세요. 마지막에는 인수인계 담당자에게 물어볼 질문을 남겨 주세요.”

3. 답변은 이런 구조로 검토하기

아래는 실제 AI 실행 결과가 아니라, 답변을 읽을 때 확인할 구조와 기준입니다.

  • 코드에서 확인한 내용

    문의 목록을 읽고 JSON으로 응답하는 라우트 코드가 제시되어 있는지, 근거로 S2와 해당 경로를 붙였는지 봅니다. 이 코드만으로 실제 배포 상태나 운영 환경의 정상 동작까지 확인했다고 쓰면 범위를 넘긴 것입니다.

  • 요구사항으로 남겨야 할 내용

    CSV 내보내기는 S1에 적힌 다음 작업입니다. 이를 완료 기능 목록에 넣지 않았는지 봅니다. 관련 코드를 추가로 확인하기 전에는 구현 여부를 열어 둡니다.

  • 테스트와 운영에서 더 확인할 내용

    S3에는 상태 코드와 배열 응답을 검사하는 테스트가 정의되어 있습니다. 실행 결과는 별도로 확인해야 합니다. 운영 담당자, 배포 주소, 롤백 절차도 S1의 빈칸 그대로 후속 질문에 남아 있어야 합니다.

마지막으로 세 가지만 확인하면 됩니다.

  • “구현됨”이라는 문장마다 실제 코드 근거와 확인 범위가 붙었나요?

  • 테스트 파일이 있다는 사실을 “테스트 통과”로 바꾸지 않았나요?

  • 모르는 운영 정보를 채워 넣지 않고, 누가 무엇을 확인해야 하는지 질문으로 남겼나요?

자기 프로젝트에 적용할 때는 같은 시점의 인수인계 메모와 관련 코드부터 좁게 잡으면 됩니다. 브랜치나 커밋, 자료 확인 날짜를 남기고, 근거를 못 찾은 항목은 다음 확인 목록으로 보냅니다. 비개발자도 AI가 붙인 파일 경로를 개발자에게 보여 주면서 “이 문장을 여기까지 확정해도 될까요?”라고 물을 수 있습니다.

같은 흐름을 더 살펴보고 싶다면 Specify의 프로젝트 인수인계 공개 가이드를 참고해 주세요.

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.09

현중님, 인수인계 문서에서 "만들어 달라고 한 것 / 코드에 있는 것 / 운영하며 확인할 것"을 먼저 나누자는 출발점이 명쾌해요.

S3처럼 테스트가 "정의되어 있다"와 "통과했다"를 분리하고, 실행 기록이 없으면 확인 불가로 남기게 하는 프롬프트 문장이 특히 실용적이었어요. 또 CSV 내보내기를 S1에 적힌 '다음 작업'으로 두고 완료 기능에 섞지 않게 하는 점검 포인트와, 제공한 발췌에 없는 기능을 "저장소 전체에 없다고 단정하지 말라"고 못 박은 부분도 AI가 흔히 하는 과장을 잘 막아 줘요.

마지막의 세 가지 체크리스트 덕분에 바로 따라 해볼 수 있겠어요. 고롱고롱… 이렇게 범위가 또렷한 글 보면 기분 좋아져요 ✨

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기