16강. 작업 쪼개기: 기능을 완료 가능한 작은 단위로 나누기

?1. 이번 강의에서 해결할 문제

“게임 완성하기”나 “사이트 만들기”는 너무 커서 어디서 시작하고 언제 끝났는지 판단하기 어렵습니다. 작업을 작은 기능으로 나누고 각 기능의 완료 증거를 정해야 합니다.

✓2. 학습 목표

✓이번 강의를 마치면

• 사용자에게 보이는 결과를 기준으로 큰 기능을 나눕니다.
• 작업마다 범위 밖 항목과 완료 기준을 씁니다.
• 구현, 검증, 문서 갱신을 하나의 완료 단위로 묶습니다.

◇3. 핵심 개념

좋은 작업은 한 번에 이해할 수 있고, 결과를 독립적으로 확인할 수 있으며, 완료 여부가 예·아니요로 판단됩니다. “코드 작성”보다 “정답 처리 시 점수가 10 증가하고 테스트가 통과한다”가 더 좋은 작업 이름입니다.

모든 기능을 하나의 GameManager, 한 컴포넌트, 한 거대한 할 일 목록에 몰아넣으면 변경 범위와 책임이 흐려집니다. 데이터, 규칙, 화면 반영처럼 이유가 다른 책임은 분리합니다.

✎4. 단계별 실습

Markdown · 파일 경로: docs/work-items/score-feature.md

docs/work-items/score-feature.md

# 점수 기능 작업 계획

## 작업 1. 점수 계산 규칙
- 범위: 정답 +10, 오답 유지, 음수 입력 거부
- 완료 기준: `tests/score.test.js`의 3개 테스트 통과
- 범위 밖: 화면 표시

## 작업 2. 점수 화면 표시
- 범위: 현재 점수를 텍스트로 갱신
- 완료 기준: 정답 1회 뒤 화면에 10 표시
- 범위 밖: 최고 점수 저장

## 작업 3. 오류와 회귀 점검
- 범위: 빠른 20회 호출과 잘못된 설정 확인
- 완료 기준: 자동 테스트와 `docs/test-checklist.md` 통과

## 작업 4. 사용법 문서
- 범위: 실행·테스트 방법 갱신
- 완료 기준: 새 터미널에서 README 명령 재현

PowerShell · 실행 위치: D:\Projects\productivity-lab

Get-Content .\docs\work-items\score-feature.md
npm.cmd run check

예상 결과: 계획의 각 완료 기준과 실제 검사 결과를 비교할 수 있습니다.

→5. 도구와 설정이 동작하는 이유

작업마다 입력, 결과와 검증 방법이 있으면 중간에 멈춰도 다음 행동을 찾기 쉽습니다. 범위 밖 항목은 현재 작업이 끝없이 커지는 것을 막고 후속 작업으로 넘길 경계를 만듭니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• ‘프론트엔드 완료’처럼 큼: 한 화면 또는 한 규칙의 관찰 가능한 결과로 줄입니다.
• 완료 기준이 ‘코드 작성’: 빌드, 테스트, 수동 결과처럼 검증 가능한 증거를 씁니다.
• 한 작업에 새 기능과 대규모 정리를 혼합: 서로 다른 목적은 별도 작업으로 나눕니다.
• 모든 기능을 한 관리자 객체에 추가: 책임과 변경 이유를 기준으로 모듈을 분리합니다.

✎7. 직접 실습

✎직접 실습

현재 만들 기능 하나를 최소 3개의 작은 작업으로 나누세요. 각 작업에 범위, 범위 밖, 완료 기준을 한 줄 이상 쓰고 첫 작업만 실제로 완료해 증거를 연결합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 좋은 완료 기준이 예·아니요로 판단되어야 하는 이유는 무엇인가요?
2. 범위 밖 항목을 적으면 어떤 문제가 줄어드나요?
3. 구현과 문서 갱신을 함께 완료해야 하는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

큰 목표를 독립적으로 검증 가능한 작은 결과로 나눕니다. 각 작업에 범위, 제외 범위, 완료 증거를 두면 진행 상태와 다음 행동이 명확해집니다.