작업 크기에 맞게 구현하기 | Build

Overview

완성된 spec.md에는 무엇을 만들지와 완료 기준이 적혀 있습니다. 이제 하나의 작업으로 바로 구현할지, 여러 Task로 나눌지 결정해야 합니다.

이번 Lesson에서는 한 번에 구현할지 여러 작업으로 나눌지 정한 뒤, 구현과 전체 검증, 자동 코드 리뷰까지 완료합니다.

학습 목표

• 만들 기능을 한 번에 구현할지, 여러 작업으로 나눌지 결정합니다.
• 전체 검증과 자동 코드 리뷰를 기준으로 구현 완료 여부를 판단합니다.

spec.md에서 구현할 결과 확인하기

먼저 Lesson 2에서 만든 docs/specs/<slug>/spec.md를 엽니다. 구현 방법을 새로 정하기보다 다음 내용을 확인합니다.

• 사용자가 최종적으로 할 수 있어야 하는 동작
• 각 동작이 완료됐다고 판단할 기준
• 구현 중 지켜야 할 가정과 제외 범위
• 아직 사람의 결정이 필요한 위험

그다음 한 가지를 묻습니다.

각 부분을 따로 완성해도 사용자가 바로 쓸 수 있는가?

따로 완성해도 각각 사용할 수 있다면 여러 Task로 나눕니다. 하나라도 빠지면 사용할 수 없다면 한 작업으로 함께 구현합니다.

Feedme는 URL 입력부터 변환, 결과 확인과 내보내기까지 모두 동작해야 사용할 수 있으므로 한 작업으로 구현합니다.

한 번에 구현할지 나누어 구현할지 정하기

모든 부분을 함께 완성해야 한다면 implement가 Spec을 바로 실행합니다. 각 부분을 따로 완성해도 사용할 수 있다면 먼저 split-into-tasks로 나누고, 사람이 제안된 Task를 승인한 뒤 implement가 순서대로 실행합니다.

두 경로의 완료 기준은 같습니다. 달라지는 것은 AI가 한 번에 맡아 진행할 작업의 크기입니다. Plan Mode는 세 번째 구현 경로가 아니라, 코드를 바꾸기 전에 상세 방법을 확인하고 싶을 때 사용하는 선택 사항입니다.

implement: 하나의 결과 바로 구현하기

implement는 선택한 Spec 폴더와 현재 코드를 읽고, 완료 기준을 충족할 때까지 구현과 검증을 이어갑니다. 승인된 Task 문서가 없다면 spec.md를 바로 실행합니다.

/implement @docs/specs/<slug>/

<slug>에는 Lesson 2에서 생성된 실제 폴더 이름을 넣습니다. Feedme는 하나의 사용자 경험으로 함께 완성해야 하므로 별도의 Task 문서를 만들지 않고 이 경로를 사용합니다.

바로 구현한다고 해서 큰 변경을 한 번에 만드는 것은 아닙니다. implement는 현재 코드와 프로젝트 지침을 조사하고, 자동으로 확인할 수 있는 동작은 TDD로 구현합니다. 자동 테스트가 어려운 화면 구성은 프로젝트 검사와 브라우저에서 확인합니다. 구현을 여러 단계로 진행하더라도 모두 하나의 기능을 완성하는 과정이므로 별도 Task로 나누지 않습니다.

구현 방법을 먼저 확인하고 싶다면 Plan Mode

코드가 낯설거나 변경 영향이 커서 구현 방법을 먼저 확인하고 싶다면 Plan Mode에서 같은 implement 명령을 실행합니다. 계획에서는 관련 파일과 기존 패턴을 제대로 반영했는지, 변경 순서와 검증 방법이 적절한지 확인합니다.

Plan Mode에서는 어떻게 구현할지만 검토합니다. 사용자 동작이나 완료 기준을 바꿔야 한다면 계획 안에서 정하지 말고 spec.md로 돌아가 결정을 수정합니다.

split-into-tasks: 여러 결과 나누기

Spec의 각 부분을 따로 완성해도 사용할 수 있다면 먼저 split-into-tasks를 실행합니다.

/split-into-tasks @docs/specs/<slug>/

이 Skill은 바로 Task 파일을 만들지 않습니다. 먼저 가장 적은 수의 Task를 제안하고, 각 Task가 전달할 동작과 선행 조건, 중간에 사람의 검토가 필요한 지점을 보여줍니다. 사람이 제안을 승인한 뒤에만 docs/specs/<slug>/tasks/에 Task 문서를 만듭니다.

split-into-tasks는 관련 작업을 사용자가 따로 쓸 수 있는 기능별로 묶습니다.

사람의 중간 확인은 보안, 데이터 변경, 권한처럼 자동 검증만으로 판단하기 어려운 위험이 있을 때만 추가합니다.

Task가 승인되면 같은 명령으로 구현을 시작합니다.

/implement @docs/specs/<slug>/

이때 implement는 tasks/의 승인된 문서를 찾아 의존 순서대로 실행하고, 각 Task의 완료 상태와 검증 근거를 Task 문서에 기록합니다. 프로젝트가 커밋을 요구하면 코드, 테스트와 Task 업데이트를 하나의 의미 있는 시점으로 함께 커밋합니다. 모든 Task가 끝나면 전체 결과를 다시 검증합니다.

전체 검증과 자동 코드 리뷰로 완료하기

기능 하나의 테스트가 통과했다고 구현이 끝난 것은 아닙니다. implement는 모든 결과를 만든 뒤 다음 두 단계를 완료 조건으로 사용합니다.

1. 관련 테스트와 전체 테스트, 정적 검사, 빌드, 실제 사용자 동작으로 spec.md의 완료 기준을 확인합니다.
2. 현재 실행 환경의 자동 코드 리뷰로 전체 구현 차이를 Spec과 완료 기준에 대조합니다.

자동 코드 리뷰에서 차단 문제가 발견되면 수정하고 영향받은 검증과 전체 리뷰를 다시 실행합니다. 리뷰 도구를 사용할 수 없다면 완료했다고 넘기지 않고 남은 검토 단계로 보고합니다.

[미션] Feedme 구현 완료하기

Lesson 2에서 spec.md를 만든 feedme-clone 저장소를 그대로 사용합니다.

Step 1: Task로 나눌지 결정하기

spec.md의 각 부분을 따로 완성해도 사용할 수 있는지 확인합니다. Feedme는 입력부터 변환, 결과 확인과 내보내기까지 함께 동작해야 하므로 별도 Task로 나누지 않습니다.

Step 2: 구현 시작하기

필요하면 Plan Mode에서 구현 방법을 먼저 확인합니다. 준비가 되면 다음 명령을 실행합니다.

/implement @docs/specs/<slug>/

Step 3: 완료 결과 확인하기

구현이 끝나면 브라우저에서 spec.md의 완료 기준이 실제로 동작하는지 확인합니다. 프로젝트의 테스트와 검사 명령이 통과하고, 자동 코드 리뷰에 차단 문제가 남아 있지 않아야 합니다.

핵심 포인트 정리

1. 따로 쓸 수 있는지 확인: 모든 부분을 함께 완성해야 한다면 implement로 바로 실행하고, 각 부분을 따로 완성해도 사용할 수 있을 때만 split-into-tasks를 사용합니다.
2. 완료는 전체 변경으로 판단: 완료 기준 전체를 검증하고 자동 코드 리뷰의 차단 문제까지 해결해야 구현이 끝납니다.

이어서 배울 내용

구현과 자동 검증이 끝나도 사람이 직접 보고 판단해야 할 결과가 남을 수 있습니다. 다음 Lesson에서는 human-review로 실제 결과를 확인하고 필요한 수정 내용을 전달합니다.