portfolio-hub/.github/templates/sdlc/4_implementation.md

0. 문서 상태

이 문서의 현재 상태와 식별 정보를 기록한다. 문서 추적과 승인 흐름에 필요한 최소 메타데이터를 적는다.

• 상태: {{DOC_STATUS:draft|review|confirmed}}
• 문서 ID: {{CYCLE_ID:sdlc-<3자리>}}
• 이슈명: {{ISSUE_NAME:짧은 한글 또는 영문 이슈명}}
• 참조 Design: {{DESIGN_PATH:docs/sdlc/<CYCLE_ID>/3_design.md}}
• 작성 시각(KST): {{CREATED_AT_KST:TBD}}
• 마지막 갱신 시각(KST): {{UPDATED_AT_KST:TBD}}

1. Design 인계 요약

Design에서 확정된 핵심 내용을 요약한다. 원본은 3_design.md를 참조하며, 이 섹션은 Implementation 작업의 입력 기준선이 된다.

이슈 목적

• {{IMP_ISSUE_PURPOSE:Design 이슈명과 핵심 목적 1-2줄}}

확정 태스크 및 변경 대상

ID	태스크 제목	변경 대상 파일/함수	담당자
T-1	{{IMP_TASK_TITLE_1}}	{{IMP_TASK_TARGET_1}}	{{IMP_TASK_OWNER_1:TBD}}
T-2	{{IMP_TASK_TITLE_2}}	{{IMP_TASK_TARGET_2}}	{{IMP_TASK_OWNER_2:TBD}}
T-3	{{IMP_TASK_TITLE_3:필요 없으면 삭제}}	{{IMP_TASK_TARGET_3}}	{{IMP_TASK_OWNER_3:TBD}}

이월된 오픈 질문 / 리스크

Design에서 Deferred 처리되어 Implementation 단계에서 해소해야 하는 항목을 기록한다.

• {{IMP_DEFERRED_ITEM_1:없으면 "없음"}}
• {{IMP_DEFERRED_ITEM_2:필요 없으면 삭제}}

2. 구현 계획

태스크(T-N)별 구현 순서와 접근 방법을 기술한다.

구현 순서

태스크 간 의존 관계와 우선순위를 고려한 구현 순서를 정의한다.

1. {{IMP_ORDER_1:예. T-1 — 기반 구조 구현 (다른 태스크의 의존 대상)}}
2. {{IMP_ORDER_2:예. T-2 — 핵심 기능 구현}}
3. {{IMP_ORDER_3:필요 없으면 삭제}}

T-1: {{IMP_TASK_TITLE_1}}

• 구현 방법: {{IMP_METHOD_1:설계 방향을 실제 코드/설정으로 구현하는 접근}}
• 변경 대상: {{IMP_TARGET_1:실제 파일 경로, 함수명, 설정 키}}
• 완료 조건: {{IMP_DOD_1:이 태스크가 완료된 것으로 간주하는 기준}}
• 주의사항: {{IMP_NOTE_1:구현 중 주의해야 할 사항. 필요 없으면 삭제}}

T-2: {{IMP_TASK_TITLE_2}}

• 구현 방법: {{IMP_METHOD_2}}
• 변경 대상: {{IMP_TARGET_2}}
• 완료 조건: {{IMP_DOD_2}}
• 주의사항: {{IMP_NOTE_2:필요 없으면 삭제}}

T-3: {{IMP_TASK_TITLE_3:필요 없으면 삭제}}

• 구현 방법: {{IMP_METHOD_3}}
• 변경 대상: {{IMP_TARGET_3}}
• 완료 조건: {{IMP_DOD_3}}
• 주의사항: {{IMP_NOTE_3:필요 없으면 삭제}}

3. 변경 파일 목록

이번 Implementation에서 생성/수정/삭제되는 파일을 미리 나열한다. 구현 완료 후 실제 결과를 반영해 갱신한다.

파일 경로	변경 유형	관련 태스크	비고
{{IMP_FILE_1}}	{{IMP_FILE_TYPE_1:생성|수정|삭제}}	{{IMP_FILE_TASK_1:T-1}}	{{IMP_FILE_NOTE_1:필요 없으면 삭제}}
{{IMP_FILE_2}}	{{IMP_FILE_TYPE_2:생성|수정|삭제}}	{{IMP_FILE_TASK_2}}	{{IMP_FILE_NOTE_2:필요 없으면 삭제}}
{{IMP_FILE_3:필요 없으면 삭제}}	{{IMP_FILE_TYPE_3:생성|수정|삭제}}	{{IMP_FILE_TASK_3}}	{{IMP_FILE_NOTE_3:필요 없으면 삭제}}

4. 리스크 및 제약

Implementation 단계에서 새로 식별된 리스크와 제약사항을 기록한다.

리스크

• R-1 ({{IMP_RISK_LEVEL_1:High|Medium|Low}}): {{IMP_RISK_1}}
  • 완화 방안: {{IMP_MITIGATION_1}}
• R-2 ({{IMP_RISK_LEVEL_2:High|Medium|Low}}): {{IMP_RISK_2:필요 없으면 삭제}}
  • 완화 방안: {{IMP_MITIGATION_2:필요 없으면 삭제}}

가정

Implementation 수행의 전제가 되는 가정을 적는다.

• IA-1: {{IMP_ASSUMPTION_1}}
• IA-2: {{IMP_ASSUMPTION_2:필요 없으면 삭제}}

오픈 질문

Implementation 진행 중 확인이 필요한 질문을 적는다.

• OQ-1: {{IMP_OPEN_QUESTION_1}}
  • 상태: {{IMP_OQ_STATUS_1:Open|Answered|Deferred|Dropped}}
  • 처리 방안: {{IMP_OQ_ACTION_1}}
  • 종료 조건: {{IMP_OQ_EXIT_1}}
• OQ-2: {{IMP_OPEN_QUESTION_2:필요 없으면 삭제}}
  • 상태: {{IMP_OQ_STATUS_2:Open|Answered|Deferred|Dropped}}
  • 처리 방안: {{IMP_OQ_ACTION_2}}
  • 종료 조건: {{IMP_OQ_EXIT_2}}

5. Verification으로 넘기기 전 확인 체크

Verification 단계로 넘기기 전에 무엇이 완료되어야 하는지 확인한다.

• 모든 T-N 태스크 구현 완료
  • 기준: {{CHECK_ALL_TASKS:각 태스크의 완료 조건(DoD)을 충족해야 한다}}
• 변경 파일 목록과 실제 변경 일치
  • 기준: {{CHECK_FILE_LIST:3_design.md의 변경 대상과 실제 변경된 파일이 일치해야 한다}}
• 단위 테스트 또는 로컬 검증 완료
  • 기준: {{CHECK_LOCAL_VERIFY:변경 사항이 로컬 환경에서 의도대로 동작하는지 확인해야 한다}}
• 모든 오픈 질문(OQ) Open 상태 없음 확인
  • 기준: OQ 목록에 Open 상태 항목이 0개이거나, 잔여 항목 전부 Deferred 처리 완료
• Freeze 확정 담당자(CONFIRMED_BY) 지정
  • 기준: {{CHECK_CONFIRMEDBY_CRITERIA:문서 승인 또는 인계 결정을 내릴 담당자가 명시되어야 한다}}

6. 파일 처리 결과

이 Implementation 문서 생성/갱신 결과와 참조 문서를 기록한다.

• 처리 결과: {{FILE_RESULT:생성|갱신|미생성}}
• 생성 경로: {{OUTPUT_PATH}}
• 참조 문서:
  • {{DESIGN_PATH:docs/sdlc/<CYCLE_ID>/3_design.md}}
  • {{REFERENCE_1:필요 없으면 삭제}}

7. 사용자 결정 필요 항목 요약

사용자나 승인자가 결정해야 하는 항목만 모아 정리한다.

DECIDE

• {{DECIDE_ITEM_1}}
• {{DECIDE_ITEM_2:필요 없으면 삭제}}

CONFIRM

• {{CONFIRM_ITEM_1}}
• {{CONFIRM_ITEM_2:필요 없으면 삭제}}

DATA

• {{DATA_ITEM_1}}
• {{DATA_ITEM_2:필요 없으면 삭제}}

8. Implementation Freeze

Verification 인계 시점의 확정 플래그와 섹션 참조만 기록한다. 내용 재작성 없이 원본 섹션을 링크로 대신한다.

섹션 참조

• 구현 계획: # 2. 구현 계획
• 변경 파일 목록: # 3. 변경 파일 목록
• 리스크/오픈 질문: # 4. 리스크 및 제약

확정 플래그

• Handoff Decision: {{FREEZE_HANDOFF_DECISION:보류}}
• Handoff Rationale: {{FREEZE_HANDOFF_RATIONALE:구현 완료 및 로컬 검증 후 Verification으로 인계}}
• Ready for Verification: {{READY_FOR_VERIFICATION:false}}
• Confirmed By: {{CONFIRMED_BY:TBD}}
• Confirmed At (KST): {{CONFIRMED_AT_KST:TBD}}

---

12. 작성 가이드

이 섹션은 작성 참고용이다. 문서 완성 후 삭제해도 된다.

• 변경 대상 파일 경로: 실제 저장소 파일 경로를 명시한다. 추정이나 가상 경로를 쓰지 않는다.
• 완료 조건(DoD): "구현 완료"처럼 모호한 표현 대신 "파일 X에 함수 Y가 추가되고 입력 Z에 대해 올바른 결과를 반환한다"처럼 측정 가능하게 작성한다.
• 오픈 질문: 구현 중 발생한 기술적 판단 사항, 외부 확인 필요 항목 등을 기록한다.
• Freeze 섹션: 모든 태스크 완료 및 로컬 검증 후 담당자가 직접 갱신한다.