완료는 코드가 아니라 확인한 결과로 말하기

이 글은 유형별 화면과 연재를 확인하기 위한 샘플 의견 글입니다. 특정 팀의 운영 원칙이나 실제 사례를 소개하지 않습니다.

‘수정했습니다’ 다음에 필요한 말

Agent가 작업을 마치고 “수정했습니다”라고 답하면 파일이 바뀌었다는 것은 알 수 있습니다. 하지만 처음의 불편이 해소됐는지는 그 말만으로 알기 어렵습니다.

검색 결과가 없을 때 안내를 넣었다면, 안내가 실제로 나오는지 확인해야 합니다. 목록 링크를 추가했다면 링크가 올바른 경로로 이동하는지 살펴봐야 합니다. 모바일이 문제였던 작업이라면 작은 화면에서의 확인도 필요합니다.

완료 보고에는 변경 설명과 검증 결과가 함께 있어야 한다고 생각합니다.

가상의 보고를 두 문장으로 써 봅니다.

검색 결과가 없을 때 안내 문구와 전체 글 목록 링크를 표시했습니다. 작은 화면에서 안내가 보이는 것과 링크가 목록으로 이동하는 것을 확인했습니다.

브라우저에서 확인하지 못했다면 그 부분도 적습니다. 빌드가 통과했다는 사실과 실제 화면을 살펴봤다는 사실은 서로 다른 근거입니다.

확인하지 않은 항목을 남겨 두면 다음 사람이 이어서 검토하기도 쉽습니다. “문제없음”이라는 한마디보다 범위가 명확한 기록이 더 유용할 때가 많습니다.

모든 수정에 긴 보고서가 필요한 것은 아닙니다. 바뀐 동작, 확인한 방법, 남은 항목을 짧게 적는 것으로 충분한 작업도 있습니다.

이 연재의 마지막 메모는 간단합니다. 완료라는 말에, 다른 사람이 확인할 수 있는 결과를 붙이자. 작업을 나누고 맥락을 건네는 과정도 결국 그 결과에 도달하기 위한 준비입니다.