모든 인사이트

기술과 교육 기록

어려운 개발 과제를 검증 가능한 작은 작업으로 나누기

‘저장 기능 만들기’를 함수 목록으로만 쪼개면 실패 상황과 완료 기준이 빠지기 쉽다. 저장·불러오기 예제로 결과물, 확인할 질문, 테스트를 함께 나누는 방법을 설명한다.

작은 부품을 나누어 조립 중인 작업대 위 목재 다리 모형

작업 목록에 ‘저장 기능 구현’이라고 적으면 할 일을 정리한 것 같다. 하지만 무엇을 저장하고, 언제 불러오며, 실패하면 어떻게 할지가 정해지지 않았다면 아직 구현 범위도 분명하지 않다.

작업을 나눈다는 것은 큰 문장을 짧은 문장으로 바꾸는 데서 끝나지 않는다. 각 조각이 무엇을 남기고, 어떤 조건에서 끝났다고 말할 수 있는지까지 정해야 한다. 다음은 작은 싱글플레이 게임의 로컬 저장 기능을 가정한 예시다.

함수 목록보다 사용자가 확인할 결과를 먼저 적는다

‘저장 클래스 작성 → 파일 입출력 작성 → 화면 연결’은 담당 코드를 나누기에는 편하다. 그러나 앞의 두 작업이 끝나도 사용자는 저장을 확인하지 못할 수 있다.

먼저 목표를 이렇게 적어 보자.

플레이어가 저장한 뒤 게임을 종료하고 다시 실행하면, 마지막으로 저장한 위치와 소지품을 복원한다.

여기에는 저장할 데이터, 저장 시점, 복원 결과가 들어 있다. 자동 저장이나 계정 간 동기화까지 넣을지는 별도 결정이다. 첫 목표에 포함하지 않았다면 목록 밖으로 빼서 관리한다.

NASA의 작업 분해 구조(WBS) 지침도 최종 목표를 달성하는 데 필요한 산출물을 중심으로 일을 계층화한다. 이 글에서는 그 관점을 빌려 사용자가 확인할 결과를 먼저 정한다. 아래 표는 작은 개발 과제에 적용한 예시이며, NASA의 공식 양식을 그대로 따른 것은 아니다.

작은 작업에 완료 조건을 붙인다

작은 작업 남길 결과 끝났는지 확인하는 방법
저장 데이터 범위 결정 위치·소지품과 데이터 버전의 정의 포함·제외 항목을 팀원이 같은 뜻으로 설명한다
저장 후 복원 연결 실제로 다시 읽을 수 있는 저장 데이터 게임을 껐다 켜도 지정한 상태가 복원된다
저장 파일이 없는 경우 처리 처음 실행하는 사용자의 시작 흐름 저장 파일 없이 실행하면 새 게임을 시작한다
손상 파일 처리 오류 안내와 복구·재시작 선택 읽을 수 없는 파일로 테스트해도 실행이 중단되지 않는다
저장 실패 처리 실패 안내와 기존 데이터 보존 동작 쓰기 실패를 재현했을 때 이전 저장을 잃지 않는다

‘문제없이 된다’ 대신 관찰할 행동을 적는다. 실패 조건을 재현하는 테스트 환경도 작업의 일부다. 실제 파일을 손상시키는 시험은 복사본에서 수행하고, 원본 사용자 데이터를 대상으로 삼지 않는다.

아직 방법을 모르는 일은 조사 작업으로 표시한다

‘이전 저장을 잃지 않는다’는 조건을 적었다고 구현 방법까지 아는 것은 아니다. 플랫폼이 제공하는 저장 방식이나 파일 교체 동작을 확인해야 할 수 있다.

이때 ‘안전하게 저장하기’라는 큰 구현 작업을 그대로 맡기기보다, 먼저 조사 결과물을 정한다.

  • 실행 대상 플랫폼의 저장 API와 실패 동작을 확인한다.
  • 중간 실패를 재현할 작은 시험 프로그램을 만든다.
  • 기존 저장 보존 여부와 남은 제약을 기록한다.
  • 결과를 바탕으로 구현 작업과 테스트 조건을 다시 정한다.

조사는 일정에서 숨겨야 하는 지연이 아니다. 구현을 시작하는 데 필요한 판단 자료를 만드는 일이다. 다만 조사만 계속되지 않도록 무엇을 결정하면 끝나는지 적어 둔다.

조각마다 잘돼도 함께 동작하는지 확인한다

파일 쓰기 테스트와 불러오기 테스트가 각각 성공해도, 실제 게임에서 저장 버튼을 눌러 종료하고 다시 실행하는 흐름은 실패할 수 있다. 저장한 데이터의 형식과 불러오는 쪽의 기대가 다르거나, 화면이 잘못된 슬롯을 읽는 경우도 생각할 수 있다.

따라서 작은 작업들을 묶는 통합 확인을 남긴다. 이 예제에서는 ‘저장 → 종료 → 재실행 → 복원’이 그 흐름이다. 버튼 연결을 마지막 날까지 미루기보다 가장 작은 데이터로 한 번 연결하고, 이후 저장 항목과 실패 처리를 늘려가는 방법을 선택할 수 있다.

스크럼 가이드의 완료의 정의(Definition of Done)는 결과물이 요구되는 품질 기준을 충족한 상태를 명시한다. 개별 기능의 수용 조건과는 구별해야 한다. ‘위치가 복원된다’가 저장 기능의 조건이라면, ‘필수 테스트 통과·검토 완료·기존 기능 회귀 확인’은 여러 기능에 공통으로 적용할 완료 기준의 예다.

새로 알게 된 조건은 계획 변경 기록에 남긴다

작업을 잘게 나눠도 조사 결과에 따라 목록이 달라질 수 있다. 스크럼 가이드는 정해진 기간의 목표와 품질을 지키면서, 더 알게 된 내용에 따라 제품 책임자와 작업 범위를 재협의할 수 있다고 설명한다. 목표·기간·품질·범위를 모두 같은 종류의 약속으로 취급하지 않는 것이 중요하다.

저장 예제에서 대상 플랫폼의 제약 때문에 예정한 실패 복구 방식을 사용할 수 없다는 사실을 확인했다고 하자. 이때 필요한 기록은 단순한 지연 표시보다 구체적이다.

  • 확인한 사실: 재현한 실패 조건과 플랫폼 문서, 시험 결과를 남긴다.
  • 영향받는 약속: 기존 저장 보존 조건과 예상 작업량 중 무엇이 달라지는지 적는다.
  • 가능한 선택: 지원 범위를 줄이거나, 다른 구현을 시험하거나, 전체 프로젝트의 일정 협의가 필요한지 구분한다.
  • 결정과 다음 확인: 누가 범위를 결정했는지, 미룬 작업과 다시 확인할 시점을 남긴다.

이 목록은 자체 제안이며 스크럼 공식 양식이 아니다. 스프린트 기간이나 품질 조건을 임의로 바꾸는 뜻도 아니다. 외부 일정·예산 변경은 해당 결정을 맡은 사람과 협의한다.

다음 작업자가 이어갈 수 있으면 더 잘 나눈 것이다

작업을 맡길 때는 ‘파일 입출력 부탁합니다’보다 다음 문장이 더 구체적이다.

지정한 위치·소지품 데이터를 저장하고 재실행 후 복원한다. 저장 파일이 없으면 새 게임으로 시작한다. 쓰기 실패 때 이전 저장이 보존되는지도 시험하고 결과를 남긴다.

그 작업이 여전히 크다면 위 표에서 흐름 하나를 골라 다시 나누면 된다. 작업을 넘겨받은 사람이 만들 결과와 끝났다고 판단할 조건을 설명할 수 있는지 보자. 둘 중 하나가 막연하다면 구현을 더 잘게 나누거나, 먼저 답할 조사 질문을 남길 차례다.

구현 방법을 모르는 이유 자체를 정리하고 싶다면 모르는 것을 발견하는 개발 질문 목록을 함께 사용할 수 있다.

참고 자료

저장 기능의 작업표와 실패 시험은 설명을 위해 이 글에서 구성했다. 특정 프로젝트의 수행 사례나 성과를 뜻하지 않는다.

모든 인사이트로 돌아가기