↓ 본문으로 건너뛰기

Definition of Done Acceptance Criteria Agile

완료의 정의(DoD)와 인수 조건의 차이, 예시와 템플릿

인수 조건은 스토리 하나가 해내야 할 일을, 완료의 정의(DoD)는 모든 스토리가 통과해야 하는 품질 체크리스트를 정합니다. 둘이 어떻게 다른지 예시와 템플릿으로 정리했습니다.

완료의 정의(DoD)와 인수 조건의 차이, 예시와 템플릿

인수 조건(Acceptance Criteria, 인수 기준이라고도 합니다)은 사용자 스토리 하나가 프로덕트 오너(Product Owner)의 승인을 받기 전에 충족해야 하는 조건입니다. 바로 이 작업이 무엇을 해야 하는지를 적은 것이죠. 완료의 정의(Definition of Done)는 팀 전체가 모든 스토리에 똑같이 적용하는 체크리스트 하나입니다. 스토리가 무엇이든, 누가 “끝났다"고 말하기 전에 넘어야 하는 품질 기준입니다. 인수 조건은 “맞는 걸 만들었나?“에 답하고, 스토리마다 다릅니다. 완료의 정의는 “제대로 만들었나?“에 답하고, 스프린트가 바뀌어도 거의 그대로입니다. 스토리는 둘 다 통과해야 끝난 겁니다.

둘을 헷갈리는 데는 그럴 만한 이유가 있습니다. 둘 다 체크박스 목록이고, 둘 다 티켓 맨 아래에 붙어 있고, 둘 다 보드의 마지막 칸으로 옮겨도 되는지를 가르니까요. 그래서 생기는 논쟁은 대개 이렇게 흘러갑니다. 개발자는 티켓에 적힌 걸 다 하니까 끝났다고 합니다. 다른 누군가는 아직 리뷰를 안 받았다거나, 노트북에서만 테스트했다거나, 한국어 오류 메시지를 아무도 안 봤다며 아니라고 하죠. 둘 다 맞습니다. 서로 다른 목록 이야기를 하고 있을 뿐입니다. 처음 팀을 맡았을 때 팀 규범을 적으면서 “완료가 정확히 무슨 뜻인가"를 아무도 입 밖에 내지 않던 가정 중 하나로 목록에 올렸는데, 그 답의 대부분이 바로 이 구분입니다.

완료의 정의와 인수 조건의 차이, 표 하나로
#

인수 조건완료의 정의
적용 대상사용자 스토리나 백로그 항목 하나팀이 끝내는 모든 항목
답하는 질문이 스토리에 필요한 일을 하는가?우리 기준에 맞게 만들었는가?
누가 쓰나프로덕트 오너가 쓰고, 개발자와 함께 다듬음팀 전체. 조직 차원의 기준이 있으면 그게 최소선
언제 쓰나스토리가 스프린트에 들어가기 전, 리파인먼트(백로그 정제)에서한 번 정하고, 회고 때 다시 봄
얼마나 자주 바뀌나스토리마다 다름드물게, 그리고 더 엄격해지는 쪽으로만
스크럼 가이드에 있나?언급 없음있음. 증분(Increment)에 대한 약속으로
예시“만료된 재설정 링크는 만료됐다고 알려 주고 새 링크를 제안한다”“다른 개발자가 리뷰했고, CI에서 테스트가 통과한다”

스크럼 가이드 줄을 보면 다들 의외라고 합니다. 2020년판 스크럼 가이드(Scrum Guide)는 완료의 정의를 “제품에 요구되는 품질 기준을 충족한 증분의 상태를 공식적으로 기술한 것"이라고 정의하고, 이를 충족하지 못한 항목은 “릴리스할 수 없으며 스프린트 리뷰에서 발표조차 할 수 없다"고 말합니다. 인수 조건은 아예 나오지 않습니다. 인수 조건은 사용자 스토리 전통, 그러니까 익스트림 프로그래밍(XP)과 그 뒤의 행동 주도 개발(Behaviour-Driven Development, BDD)에서 왔습니다. 그런데도 대부분의 스크럼 팀이 인수 조건을 씁니다. 인수 조건 없는 스토리는 알아서 짐작하라는 말이나 다름없으니까요.

완료의 정의와 인수 조건 예시: 스토리 하나로 보기
#

웬만한 제품의 백로그 어딘가에는 이런 스토리가 있습니다.

비밀번호를 잊어버린 고객으로서, 내 계정에 다시 들어갈 수 있도록 이메일로 비밀번호를 재설정하고 싶다.

이 스토리의 인수 조건을 Given/When/Then 시나리오로 쓰면 이렇습니다.

Scenario: 재설정 링크 요청
  Given 로그인 페이지에 있다
  When "비밀번호 찾기"를 누르고 내 계정의 이메일 주소를 입력한다
  Then 1분 안에 재설정 링크가 이메일로 온다
  And 페이지에 받은편지함을 확인하라는 안내가 나온다

Scenario: 계정이 없는 이메일 주소
  Given 내가 입력한 주소를 쓰는 계정이 없다
  When 재설정 링크를 요청한다
  Then 페이지에 똑같이 "받은편지함을 확인하세요" 메시지가 나온다
  And 이메일은 발송되지 않는다

Scenario: 만료된 링크
  Given 재설정 링크가 발급된 지 30분이 넘었다
  When 링크를 연다
  Then 링크가 만료되었다는 안내가 보인다
  And 같은 페이지에서 새 링크를 요청할 수 있다

Scenario: 새 비밀번호 정하기
  Given 유효한 재설정 링크를 열었다
  When 비밀번호 규칙에 맞는 새 비밀번호를 입력한다
  Then 로그인된다
  And 이전 비밀번호와 다른 재설정 링크는 모두 더 이상 동작하지 않는다

인수 조건이 있는 이유를 가장 잘 보여 주는 게 두 번째 시나리오입니다. 계정이 있든 없든 같은 메시지를 보여 주면, 낯선 사람이 이 폼으로 어떤 이메일 주소가 가입돼 있는지 알아낼 수 없습니다. 이건 제품 차원의 결정이라 누군가는 내려야 하고, 내리기 가장 좋은 때는 나중에 리뷰 댓글에서가 아니라 누구도 코드를 쓰기 전입니다.

그리고 이게 팀의 완료의 정의입니다. 이 스토리든 다른 어떤 스토리든 똑같습니다.

- [ ] 다른 개발자가 코드를 리뷰하고 승인함
- [ ] 새 동작에 대한 자동화 테스트를 작성했고, CI에서 모두 통과함
- [ ] 로컬뿐 아니라 스테이징에서 인수 조건을 확인함
- [ ] 스테이징 배포 후 오류 추적 도구에 새 오류가 없음
- [ ] 사용자에게 보이는 문구를 제품이 지원하는 모든 언어로 추가함
- [ ] 동작이 바뀌었다면 API 문서나 변경 기록(changelog)을 업데이트함
- [ ] 프로덕트 오너가 동작하는 모습을 직접 봄

세 번째 줄을 보세요. 완료의 정의는 인수 조건을 충족해야 한다고 말하고, 인수 조건은 그 조건이 무엇인지를 말합니다. 두 목록은 이렇게 이어지고, 그래서 어느 쪽도 다른 쪽의 일까지 떠맡으려 들면 안 됩니다.

준비 완료의 정의(DoR)는 어디에 들어가나
#

이 계열의 세 번째 용어는 준비 완료의 정의(Definition of Ready)입니다. 팀이 스토리를 스프린트로 가져오기 전에 그 스토리가 갖춰야 할 짧은 체크리스트죠. 보통은 인수 조건, 추정치, 파악된 의존성, 그리고 스프린트 안에 끝낼 수 있는 크기를 요구합니다. 이것도 스크럼 가이드에는 없습니다. 2020년판 가이드에는 “스크럼 팀이 한 스프린트 안에 완료(Done)할 수 있는” 항목은 “선택할 준비가 된 것으로 본다"는 말만 있습니다.

순서로 보면 이렇습니다. 출발선에 준비 완료의 정의, 스프린트 전에 쓰고 끝날 때 확인하는 인수 조건, 결승선에 완료의 정의. 인수 조건이 없는 스토리는 준비된 게 아닙니다. 아직 아무도 잘 몰라서 인수 조건을 쓸 수 없다면 스파이크가 먼저 필요할 가능성이 큽니다. 다만 준비 완료의 정의는 짧게 유지하세요. 엄격한 관문처럼 다루기 시작하면 일을 거절하는 수단이 되고, 반쯤 이해한 스토리를 두고 오가야 할 쓸모 있는 대화가 사라집니다.

쓸모 있는 인수 조건 작성법
#

할 일(task)이 아니라 사용자나 시스템이 하는 일을 적으세요. “reset_tokens 테이블 만들기"는 어떻게 만들지에 관한 것이라 개발자의 계획에 들어갑니다. “이전 비밀번호가 더 이상 동작하지 않는다"는 참이어야 하는 사실이고, 이게 인수 조건입니다.

조건 하나하나는 논쟁 없이 통과와 실패가 갈리게 쓰세요. “이메일이 빨리 온다"는 리뷰에서 논쟁거리가 되지만, “1분 안에"는 그렇지 않습니다.

실패 경로(unhappy path)도 다루세요. 만료된 링크, 가입되지 않은 주소, 같은 링크를 두 번 누르는 경우에 버그가 살고, 아직 아무도 정하지 않은 제품 질문도 거기 숨어 있습니다.

개수는 셋에서 일곱 개 사이를 목표로 하세요. 그보다 훨씬 많으면 대개 스토리 두 개가 하나로 뭉쳐 있는 겁니다.

형식은 스토리마다 고르세요. Given/When/Then은 행동 주도 개발에서 왔고 자동화 테스트와 UAT 스크립트로 그대로 옮겨지기 때문에, 흐름이 있는 기능이라면 저는 이 형식을 좋아합니다. 단순한 규칙이라면 평범한 체크리스트로 충분합니다(“이 필드는 1–200자를 받는다”). 모든 조건을 억지로 Given/When/Then에 끼워 맞추면 문장만 길어집니다.

리파인먼트에서, 개발자들이 함께 있는 자리에서 쓰세요. 인수 조건의 주인은 프로덕트 오너지만, “링크를 두 번 열면 어떻게 돼요?“라고 묻는 건 실제로 만들 사람들입니다.

실제로 쓰이는 완료의 정의 작성법
#

이상적인 목록이 아니라, 팀이 잘 굴러가는 날 이미 하고 있는 것에서 시작하세요. 다들 슬그머니 절반은 건너뛰는 완료의 정의는 없느니만 못합니다. 체크리스트는 장식일 뿐이라고 팀에 가르치는 셈이니까요.

일이 실제로 일어나는 곳에 두세요. 제가 일했던 팀들은 위키 페이지에 적어 뒀습니다. 아예 안 적는 것보다는 훨씬 낫지만, 페이지는 누군가 열어 볼 생각을 해야 읽히고, 그게 보통 회고 때죠. 풀 리퀘스트 템플릿에 들어 있으면 변경할 때마다 체크됩니다.

<!-- .github/pull_request_template.md -->
## 무엇을, 왜 바꿨나

## 완료의 정의
- [ ] 테스트를 추가하거나 고쳤고, CI에서 통과함
- [ ] 스테이징에서 인수 조건을 확인함
- [ ] 사용자에게 보이는 새 문구를 지원하는 모든 언어로 추가함
- [ ] 동작이 바뀌었다면 문서나 변경 기록을 업데이트함

모든 줄을 확인할 수 있게 쓰세요. “코드가 깔끔하다"는 누구도 정직하게 체크할 수 없는 줄입니다. “다른 개발자가 리뷰하고 승인함"은 체크할 수 있죠.

기준은 의도적으로 올리세요. 팀이 지금 목록을 무리 없이 지키고 있다면 다음 항목을 더합니다. 위험한 변경에는 기능 플래그를, 조용히 실패할 수 있는 새 기능에는 알림을 다는 식으로요. 그걸 정하기에 자연스러운 자리가 회고입니다.

여러 팀이 한 제품을 만든다면 스크럼 가이드는 그 팀들이 “같은 완료의 정의를 함께 정의하고 준수해야 한다"고 말합니다. 조직에 표준 완료의 정의가 있다면 모든 팀은 그걸 “최소한” 따라야 하고요. 그러니 팀은 거기에 더할 수는 있어도 뺄 수는 없는 셈이죠.

자주 보이는 실수
#

완료의 정의를 스토리마다 인수 조건에 복사해 넣는 것. “테스트 작성"이나 “코드 리뷰"는 스토리에 들어갈 내용이 아닙니다. 티켓마다 덩치만 키우고, 정작 그 스토리에 관한 조건을 묻어 버립니다.

알고 보면 할 일이거나 알고 보면 디자인인 인수 조건. “모달을 쓴다"는 디자인 결정입니다. “페이지를 떠나지 않고 새 링크를 요청할 수 있다"가 인수 조건이고, 이렇게 써 두면 디자이너가 모달보다 나은 방법을 찾을 여지가 남습니다.

스프린트 도중에 말없이 인수 조건을 바꾸는 것. 요구사항이 바뀌었다면 프로덕트 오너와 이야기할 일이고, 새 스토리가 되는 경우도 많습니다. 기존 스토리를 조용히 고칠 일이 아닙니다.

“다 됐는데, 진짜 다 된 건 아니에요.” 머지는 했지만 아직 아무도 스테이징에서 확인하지 않은 스토리를 완료로 친다면, 팀은 정의 두 개를 하나라고 부르며 쓰고 있는 겁니다. 완료가 정확히 어디서 끝나는지 완료의 정의에 적어 두세요.

스프린트 안에 아무도 다 지킬 수 없을 만큼 긴 완료의 정의. 그러면 다들 서로 다른 줄을 건너뛰고, 아무도 그 얘기를 꺼내지 않습니다.

사용자 인수 테스트(UAT)와의 관계
#

인수 조건은 사용자 인수 테스트의 자연스러운 출발점입니다. 시나리오 하나하나가 팀 밖의 사람도 따라 할 수 있는 테스트 케이스가 되죠. UAT는 인수 조건 자체도 검증합니다. 사용자가 모든 시나리오를 통과하고도 여전히 자기 일을 못 할 때가 있는데, 그건 코드가 아니라 인수 조건이 틀렸다는 뜻입니다. 다음 스토리를 쓰기 전에 알아 두면 좋은 사실이죠.

인수 조건 템플릿과 완료의 정의 템플릿
#

인수 조건:

**스토리:** [사용자 유형](으)로서, [이유]할 수 있도록 [목표]하고 싶다.

**인수 조건**
- Given [시작 상태], when [행동], then [결과].
- Given [시작 상태], when [행동], then [결과].
- Given [시작 상태], when [행동], then [결과].

**범위 밖:** [이 스토리가 일부러 하지 않는 것]

“범위 밖” 줄은 선택 사항이지만, 저라면 남겨 둡니다. 리뷰 때 벌어질 논쟁을 시작되기도 전에 꽤 많이 끝내 주거든요.

줄이거나 보태서 쓸 수 있는 기본 완료의 정의:

- [ ] 다른 개발자가 코드를 리뷰하고 승인함
- [ ] 자동화 테스트를 작성했고 CI에서 통과함
- [ ] 스테이징에서 인수 조건을 확인함
- [ ] 스테이징 배포 후 모니터링에 새 오류나 경고가 없음
- [ ] 사용자에게 보이는 문구를 지원하는 모든 언어로 추가함
- [ ] 동작이 바뀌었다면 문서, 변경 기록, 릴리스 노트 중 해당하는 것을 업데이트함
- [ ] 프로덕트 오너가 동작하는 모습을 직접 봄

짧게 정리하면
#

인수 조건은 스토리 하나에 속합니다. 그 스토리가 무엇을 해야 하는지 말하고, 스프린트 전에 프로덕트 오너가 팀과 함께 쓰며, 매번 다릅니다. 완료의 정의는 팀에 속합니다. 모든 스토리가 통과해야 하는 품질 기준 체크리스트 하나이고, 팀이 변경할 때마다 눈에 띄는 곳에 있으며, 팀이 기준을 올리기로 할 때만 바뀝니다. 준비 완료의 정의는, 쓴다면, 둘보다 앞에 서서 스토리가 시작할 가치가 있을 만큼 충분히 구체적인지(인수 조건 포함) 확인합니다.

더 읽을거리
#

이 사이트의 관련 글:

외부 리소스:

댓글

댓글은 검토 후 게시됩니다.