AI 개발 프로젝트, 납품 전에
확인할 것들.

검색어와 찾아야 할 내용을 먼저 정했습니다.

검색창에 평소 쓰는 말을 넣었는데 필요한 글이 나오지 않으면 답답하죠. Blackbold 검색에도 이런 문제가 있었습니다. ‘개발의뢰’처럼 붙여 쓴 말이나 ‘교육받았는데 못써요’처럼 상황을 설명하는 말을 입력하면 필요한 내용을 찾지 못했습니다.

먼저 놓치던 검색어를 모으고, 각 검색어에서 어떤 안내나 글이 나와야 하는지 정했습니다. AI에게도 이 목록을 주고 검색 코드를 고치도록 했죠. 고칠 기능과 확인할 결과를 함께 정한 것입니다.

검색에서 확인할 결과의 예‘개발의뢰’를 입력해도
개발 상담에 필요한 안내를 찾을 수 있어야 합니다.

수정한 뒤에는 같은 검색어를 다시 입력해봤습니다. 결과가 나온다는 것만으로는 충분하지 않겠죠. 사람이 글을 읽고 검색한 의도에 맞는지 확인했습니다. 이 검색어들은 다음 수정 때도 다시 검사할 수 있도록 남겨두었습니다.

개발을 맡길 때도 직원이 실제로 무엇을 입력하고 어떤 결과를 받아야 하는지 함께 적어보세요. “검색 기능을 만들어주세요”보다 원하는 결과를 구체적으로 설명할 수 있겠죠. 납품받을 때도 같은 예시로 확인할 수 있습니다.

잘 되는 검색어만 골라서 확인하지 않았습니다.

추가로 준비한 검색어 69개를 수정 전 검색기에 넣어봤습니다. 그중 43개에서 기대한 결과가 나왔습니다. 검색을 고친 뒤 같은 69개를 다시 넣었을 때는 모두 기대한 결과가 나왔습니다.

찾아야 할 글을 놓치지 않는지도 중요하지만, 관계없는 글을 추천하지 않는지도 봐야겠죠. AI나 교육과 관계없는 검색어라면 일부 글자가 같다는 이유로 관련 글을 추천해서는 안 됩니다.

기존에 검사하던 140개와 추가한 69개를 합쳐 총 209개 항목을 검사했습니다. 이 중 175개는 관련 결과를 찾아야 하는 질문, 34개는 무관한 결과를 추천하지 않아야 하는 질문입니다.

깃허브에 수정 내용과 검사 결과를 함께 남겼습니다.

수정한 파일과 기록은 어디에 남겨야 할까요? Blackbold는 깃허브(GitHub)에 저장했습니다. 깃허브는 웹사이트를 만드는 파일과 수정 기록을 함께 보관하는 온라인 공간입니다. 문제가 생기면 이전 파일과 비교하며 어디서 달라졌는지 확인할 수 있습니다.

실제 사이트에 바로 반영하기 전에 작업용 사본에서 수정하고, “이 내용을 확인해주세요”라는 검토 요청을 만들었습니다. 개발에서는 작업용 사본을 브랜치, 검토 요청을 PR이라고 부릅니다. 수정할 공간과 확인할 단계를 나눠둔 것이죠.

1. 1
   변경한 파일과 이유를 남겼습니다.검토 요청에 무엇을 고쳤고 무엇을 유지했는지 적었습니다.
2. 2
   자동 검사와 미리보기를 확인했습니다.깃허브 액션이 검사를 실행하고 클라우드플레어 미리보기를 만들었습니다. 사람은 그 화면을 보고 문구와 배치를 확인했습니다.
3. 3
   확인한 버전을 운영 사이트에 반영했습니다.확인한 파일을 최종본에 합친 뒤 실제 사이트에 올렸습니다. 이렇게 사용자가 볼 수 있게 올리는 일을 배포라고 합니다. 반영 후에는 실제 주소를 열어 새 내용이 보이는지 다시 확인했습니다.

납품받을 때도 “배포했습니다”라는 설명을 들었다면 실제 주소를 열어보세요. 검토했던 내용이 반영됐나요? 바꾸지 않기로 한 기능도 그대로인가요? 확인한 버전과 실제로 쓰는 버전이 같은지까지 살펴봐야겠죠.

사이트를 공개한 뒤 검색엔진에도 알렸습니다.

사이트가 잘 열린다면 검색에서도 찾을 수 있을까요? 공개 여부와 검색 등록 상태는 따로 확인해야 합니다. Blackbold는 구글 서치 콘솔과 네이버 서치어드바이저에서 페이지를 확인했습니다. 이미 요청한 주소를 다시 신청하지 않도록 기존 내역부터 살폈습니다.

추가로 요청한 3페이지는 신청이 접수된 것까지 확인했습니다. 접수됐다고 바로 검색 결과에 나오는 것은 아니죠. 실제 색인과 검색 노출은 이후에 따로 확인해야 합니다.

기록을 남길 때도 “요청 접수”와 “실제 검색 노출”을 나눠 적어두세요. 다음 담당자가 같은 신청을 반복하거나 이미 검색에 나온다고 오해하는 일을 줄일 수 있겠죠.

다음 담당자가 이어서 고칠 수 있게 정리했습니다.

다음 담당자가 맡아도 계속 고칠 수 있을까요? 어떤 파일을 바꿨는지, 검사에서 무엇을 확인했는지, 아직 남은 일은 무엇인지 한곳에 정리했습니다. 처음부터 다시 설명을 듣지 않고도 작업을 이어갈 수 있게 남긴 것이죠.

그래서, 무엇이 달라졌을까요?

놓치던 검색 표현을 찾도록 고쳤고, 추가한 검색어 69개는 다시 검사했을 때 모두 기대한 결과가 나왔습니다. 뉴스룸에서는 새로 개선한 글이 목록에 보이는지도 확인했습니다.

새 담당자나 다른 AI가 작업을 이어갈 때도 이 문서부터 읽게 합니다. 이미 끝낸 일을 다시 하거나 이전 화면으로 덮어쓰지 않으려면, 어디까지 끝났고 무엇을 유지해야 하는지 알아야겠죠.

이번 작업에서 AI는 파일을 고치고 반복 검사를 실행했습니다. 사람은 검색 결과와 화면을 살펴 수정할 부분을 알려주고 공개 여부를 결정했습니다. 수정 내용과 확인 결과를 남겨 다음 작업자가 이어갈 수 있게 했습니다. Blackbold 웹사이트에서 직접 적용한 방식입니다.