Technote

개발 워크플로우 실무

연재 개발자를 고용하기 전에 알아야 할 것 8부 중 4부

“완성” 의 정의를 계약 전에 정합니다

완료 기준이 없으면 인수는 감상평 교환이 됩니다. 미리 정한 판정 기준은 발주자를 지키는 동시에 수주자를 무한 수정에서 지킵니다.

제작이 거의 끝나갈 무렵 가장 흔한 대화는 이렇습니다. “이 정도면 된 것 같은데요.” “저는 조금 아쉬운데요.” 두 사람 다 맞는 말을 하고 있고, 그래서 결론이 나지 않습니다. 완성의 정의가 어디에도 적혀 있지 않기 때문입니다.

인수 조건(acceptance criteria)은 이 대화를 없애기 위한 문서입니다. 어렵게 쓸 필요는 없고, “무엇을 해 보면 됐다고 할 것인가” 를 문장으로 적으면 됩니다. 계약 전에 적어야 의미가 있습니다 — 작업이 끝난 뒤에 적으면 그것은 조건이 아니라 요구가 됩니다.

좋은 인수 조건의 두 가지 성질

첫째, 제3자가 확인할 수 있어야 합니다. “빠르게” 는 확인할 수 없지만 “휴대폰 환경에서 첫 화면이 3초 안에 보인다” 는 확인할 수 있습니다. 둘째, 해 보는 방법이 함께 적혀야 합니다. 어떤 도구로 어떤 조건에서 재는지가 없으면 같은 항목을 두고 서로 다른 결과를 들고 오게 됩니다.

이 두 가지가 갖춰지면 인수는 판정이 됩니다. 통과하면 잔금을 지급하고, 통과하지 못하면 무엇이 남았는지가 자동으로 목록이 됩니다.

인수 조건이 있을 때의 흐름 — 마지막 단계에서 판단할 것이 없다

워드프레스 사이트라면 이런 항목들

업종과 무관하게 거의 모든 사이트에 공통으로 넣을 수 있는 조건이 있습니다. 아래를 기본으로 두고 우리 사업에 필요한 것을 더하면 됩니다.

기본 인수 조건 — 각 줄은 실제로 해 볼 수 있는 동작이다

세 번째 줄은 특히 자주 빠집니다. 제작 중에 켜 두는 색인 차단 설정을 오픈하면서 끄지 않는 사고인데, 이 상태에서는 글을 아무리 써도 검색에 나오지 않습니다. 인수 조건에 한 줄로 넣어 두면 이 사고가 구조적으로 사라집니다.

다섯 번째 줄도 중요합니다. 우리가 직접 고칠 수 있는 영역이 어디까지인지는 결과물의 성격을 크게 바꿉니다. 문구 수정 때마다 업체에 연락해야 하는 구조라면 그것도 하나의 선택이지만, 선택했다는 사실을 인수 시점에 알아야 합니다.

속도와 점수를 조건에 넣을 때

성능이나 검색 점수를 인수 조건에 넣고 싶다면 측정 조건을 함께 적습니다. 어떤 페이지를, 어떤 도구로, 모바일인지 데스크톱인지, 몇 회 측정해 어떤 값을 쓸 것인지를 정합니다. 측정은 조건에 따라 결과가 달라지므로, 조건이 없는 숫자는 분쟁의 씨앗이 됩니다.

같은 이유로 작업 전 값을 먼저 재 둡니다. 개선을 약속받았다면 개선 전 상태가 기록되어 있어야 비교가 가능합니다. 우리가 작업을 맡을 때 전/후 측정을 원칙으로 두는 이유도 이것입니다 — 측정하지 않은 것은 보장할 수 없기 때문입니다.

같은 요구라도 측정 조건이 붙으면 판정이 가능해진다

조건은 수주자도 지킵니다

인수 조건을 까다롭게 적는 것이 상대를 압박하는 일처럼 느껴질 수 있지만, 실제로는 반대입니다. 조건이 없으면 수정 요청이 언제 끝날지 아무도 모릅니다. 통과 기준이 명시되면 수주자는 그 지점까지 책임지고, 그 이후는 별도 작업으로 정당하게 청구할 수 있습니다. 양쪽 모두 예측 가능해집니다.

우리가 어떤 기준으로 작업을 끝났다고 판단하는지는 작업 과정에 단계별로 적어 두었고, 무엇이 포함되고 무엇이 포함되지 않는지는 최적화 지원 사업 페이지에 함께 적혀 있습니다.

다음 회차

인수 조건을 통과했다면 이제 넘겨받을 차례입니다. 다음 회차는 인수 목록입니다 — 파일과 계정 중에 무엇을 받아야 정말로 끝난 것인지 정리합니다.

이 주제의 다른 글

노하우 목록으로

개발 워크플로우 실무

워드프레스를 GitHub 에 올릴 때의 .gitignore

워드프레스 저장소에서 커밋해야 할 것과 절대 커밋하면 안 되는 것의 경계는 명확합니다. wp-config.php 한 파일이 저장소에 들어가는 순간 DB 비밀번호와 인증 솔트가 통째로 유출됩니다.

개발자 · 운영 · 관리자 5분 읽기

개발 워크플로우 실무

취향 논쟁을 규칙 확인으로 바꾸는 디자인 리뷰

"좀 답답해 보인다" 는 반박할 수 없고 고칠 수도 없습니다. 간격 척도 밖의 값, 팔레트 밖의 색, 기준 미달 대비, 빠진 상태 — 네 항목만 규칙으로 바꿔도 리뷰의…

디자이너 4분 읽기

₩270,000 · 신청하기