지속 가능한 인수 테스트 주도 개발 #우아콘2023 #우아한형제들

인수 테스트로 개발해 나가는 방법론이 ATDD(인수 테스트 주도 개발)다. 요구사항만 보고 작성하는 것이 아니라 사용자 스토리·인수 조건 같은 추가 작업을 함께 하며, 인수 테스트 이후 기능 구현 시 TDD를 활용하는 경우가 많다.

자신의 팀은 전체 프로세스를 한 번에 도입하지 않고 필요한 부분부터 점진적으로 적용했다. 처음엔 "인수 테스트를 먼저 작성하는 규칙"만 세웠고, 이후 인수 조건 도출, 사용자 스토리 도출 과정을 차례로 경험했으며 발표도 이 순서로 진행한다. 또한 개발 문화를 지속시키는 핵심은 "왜 필요한지에 대한 공감"으로, 아무리 좋은 실천법도 공감을 얻지 못하면 지속되기 어렵다고 강조한다.

류성현 님은 처음부터 인수 테스트를 좋아한 것은 아니었지만 그 필요성을 절감한 계기를 회고한다. 우아한테크코스는 교육 시스템을 직접 개발·운영하는데, 낯선 도메인에 익숙하지 않은 기술 스택으로 "멘붕"이었을 때 인수 테스트가 한 줄기 빛이 되었다. 인수 테스트는 시스템 기능과 동작 시나리오, 세부 스펙을 한눈에 파악하게 해줬다. 강의 자료가 수강 신청 시점에 보이는지 시작 후에 보이는지 같은 것을, 매번 로컬에 띄우고 데이터셋을 갖추는 대신 인수 테스트로 보고 이해하거나 돌려보며 체감할 수 있었다.

당시 작성 규칙은 단순했다. 인수 테스트가 "블랙박스 성격"을 가지므로 프로덕션 코드에 덜 의존적이도록 API 레벨에서 픽스처(fixture)로 작성하는 규칙만 정했다. 나중에 다 갈아엎어야 할까 불안했지만 우려한 상황은 오지 않았고, 개선은 정기 회의나 실제 문제 발생 시 진행했다.

개선은 "그때그때 바로"가 아니라 문제가 생기고 공감대가 있으며 모두가 같은 해결책을 바라볼 때만 진행했다. 문제나 해결책에 공감이 없으면 각자 옳다고 생각하는 해결책을 주장하게 되고 다수결로 정하기도 애매하기 때문이다. 반면 실제 문제가 발생하면 문제·영향·해결 방향이 명확해 거의 개선을 해 나갔고, 이때도 우선순위에 맞춰 급한 것을 먼저 해결하고 근본 원인을 찾아 점진 개선했다.

구체적 사례로 가장 중요한 인수 테스트가 깨진 상황을 든다. 원인은 테스트 격리가 안 되어, 의존하던 다른 테스트의 픽스처를 수정하자 영향을 받은 것이었다. 다만 테스트 개선은 우선순위가 낮아 자주 밀렸고, 밀릴 때마다 찝찝한 마음으로 개발을 이어갔다고 솔직히 털어놓는다.

격리 문제를 풀며 픽스처 네이밍 컨벤션을 피드백받아 정하고, 논의 내용을 항상 기록해 같은 논의 반복을 막았으며, 규칙이 자리 잡으면 새 팀원을 위해 가이드를 계속 갱신했다. 그러나 기능이 늘자 인수 테스트도 늘어 코드가 복잡해졌고, 가장 큰 문제는 새 팀원이 "바쁘다", "이걸 왜 하는지 모르겠다"며 인수 테스트를 작성하지 않는 것이었다. 그래서 필요성에 대한 공감대를 먼저 만들고, 테스트를 더 쉽고 재사용하기 좋게 만들기로 했다.

그 방법으로 큐컴버(Cucumber)를 도입한다. 줄글 시나리오에 메서드를 매핑하는 도구로, 바로 도입하지 않고 설득·논의 후 기존 테스트를 점진적으로 옮겼다. 도메인 이름으로 파일·메서드를 구분해 검색이 잘 되게 하고, 로컬 변수 대신 공유 객체(shared object)로 이전 단계 데이터를 관리했다. 도입 후 작성자가 늘고 피드백은 좋았지만 러닝 커브·초기 설정 비용·컨벤션으로 커버 안 되는 케이스라는 한계도 남았다.

이어 "무엇을 검증하지"라는 고비가 온다. 검증 대상이 모호하고 팀원마다 시나리오가 다르거나 해피 패스만 검증하는 문제로, 인수 조건을 개발자·기획자·QA가 함께 도출해 공통의 이해를 도모하기로 했다. 해결할 문제를 사용자 스토리로 도출하고, 완료 조건을 뽑은 뒤 검증 시나리오를 "다 같이" 도출하며 생각의 차이를 좁혔다. 마지막으로 사용자 스토리 매핑도 시도하며, 그라운드 룰 설정·질문 장려·시간 관리·형식보다 점진적 접근·결과물보다 대화와 싱크에 집중하라는 팁을 제시한다. 핵심은 "기본 접근으로 시작해 상황에 맞는 변화를 추구"한 것이며, 지속 가능한 문화에는 공감대 형성·지속적 리뷰·완벽하지 않아도 된다는 마음가짐이 중요하다고 강조하며 마무리한다.