15. 결과 확인과 막혔을 때의 대처

확인은 요청과 짝을 이룹니다

“연락 링크를 넣어 줘”라고 부탁했다면 링크가 보이는지와 실제로 정한 곳을 여는지를 함께 확인합니다. “휴대전화에서 읽기 쉽게”라고 했다면 좁은 화면에서 글이 잘리지 않는지 봅니다. 요청의 표현을 확인할 행동으로 바꾸는 것이 결과 검증입니다.

AI가 “정상입니다”라고 답해도 실제로 어디까지 확인했는지 구분합니다. 코드에 링크가 들어 있는지 확인한 것과 브라우저에서 링크를 열어 본 것은 다릅니다. 모든 것을 혼자 증명해야 한다는 뜻은 아닙니다. 확인한 것과 아직 확인하지 못한 것을 나누어 기록하면 됩니다.

평소와 다른 입력도 생각하기

입력칸이 있는 화면은 올바른 값뿐 아니라 빈칸이나 긴 글도 만납니다. 링크 이름을 비워 두면 무엇이 보일지, 검색 결과가 없으면 어떻게 알려 줄지 생각해 볼 수 있습니다. 사용자가 실수했을 때 이해할 수 있는 안내가 나오는지도 기능의 일부입니다.

소개 페이지는 글·링크·좁은 화면을, 링크 모음은 추가·검색·빈 입력·잘못된 주소·다시 열기를 중심으로 확인합니다. 모든 페이지에 같은 긴 검사표를 쓰기보다 그 페이지의 목적과 기능에 맞는 항목을 고릅니다.

빈 화면이 곧 코드 오류는 아닙니다

화면이 열리지 않는 이유는 여러 가지입니다. 아직 만드는 중일 수도 있고, 이전 결과를 열었을 수도 있고, 계정의 사용량 제한에 걸렸을 수도 있습니다. 도구 자체의 접속 문제라면 코드 문장을 바꾸어도 해결되지 않습니다.

원인을 아직 모를 때 “잘못된 것 같으니 전부 새로 만들어 줘”라고 하면 확인할 단서가 사라질 수 있습니다. 현재 결과를 보관하고 증상부터 설명합니다.

도움이 되는 오류 설명

좋은 설명에는 한 행동, 기대한 결과, 실제 결과가 들어 있습니다. “링크를 추가한 뒤 검색어를 지웠는데 목록이 비어 있어. 전체 목록이 다시 보이길 기대했어”처럼 말합니다. 오류 문장이 있다면 비밀 정보를 가린 뒤 그대로 함께 전달합니다.

AI가 원인을 추측하면 어떤 확인으로 그 추측을 검증할지 물을 수 있습니다. 수정 후에는 같은 순서를 다시 해 봅니다. 예전 문제가 사라졌는지뿐 아니라 잘되던 링크나 입력도 유지되는지 확인합니다. 이유를 모르는 삭제나 설치를 계속 반복하기보다, 작업을 멈추고 현재 상태를 정리해 도움을 받는 편이 나을 때도 있습니다.

한 번의 확인으로 알 수 없는 것

내 컴퓨터에서 링크가 열렸다는 확인은 그 환경에서 링크를 열어 봤다는 증거입니다. 모든 기기에서 항상 같은 결과가 나온다는 뜻까지 포함하지는 않습니다. 반대로 한 번 실패했다고 모든 사용자가 실패하는 것도 아닙니다. 주소·기기·브라우저·행동을 함께 기록하면 내가 확인한 범위를 정확하게 설명할 수 있습니다.

첫 프로젝트에서는 이런 한계를 이유로 끝없이 시험할 필요는 없습니다. 목적에 맞는 대표 행동을 정하고, 직접 해 본 결과와 못 해 본 결과를 구분하면 됩니다. 소개 페이지라면 읽기와 링크, 링크 모음이라면 추가와 검색과 다시 열기가 중심입니다. 아직 가입이나 결제를 만들지 않았다면 그 기능의 시험을 끼워 넣을 필요도 없습니다. 확인의 범위는 프로젝트의 범위와 함께 정합니다.

같은 문제를 다시 볼 수 있게 설명하기

‘가끔 안 돼요’라는 상황에도 단서를 남길 수 있습니다. 어떤 순서로 무엇을 눌렀는지, 직전에 어떤 값을 넣었는지, 어느 주소와 기기에서 일어났는지 적습니다. 다시 해도 같은 현상이 생기는지 확인하면 원인을 좁히기 쉽습니다. 같은 현상을 다시 만드는 일을 재현이라고 부릅니다.

재현이 안 되더라도 거짓으로 순서를 단정하지 않습니다. 한 번 발생했고 다시는 보지 못했다는 사실을 그대로 적을 수 있습니다. 오류가 나타난 시점의 화면과 안내 문장이 있으면 도움이 됩니다. 내가 확인한 사실과 원인에 대한 추측은 구분해서 전달합니다.

꼭 기억하세요

문제를 만났을 때는 상태와 순서를 정확히 설명하고, 수정 후 같은 행동으로 다시 확인합니다.