trex/portfolio-hub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
02ffd32f2ac94d887ca587727561c0dde6c001cb
portfolio-hub/.github/templates/sdlc/2_planning.md
T
genichin dbc74db3b0 update stage-pilot
2026-04-23 04:32:10 +00:00

9.6 KiB
Raw Blame History

0. 문서 상태

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

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

1. Discovery 인계 요약

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

이슈 목적

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

확정 범위

  • In Scope
    • {{PLANNING_IN_SCOPE_1}}
    • {{PLANNING_IN_SCOPE_2}}
  • Out of Scope
    • {{PLANNING_OUT_OF_SCOPE_1}}
    • {{PLANNING_OUT_OF_SCOPE_2}}

기능 요구사항 (FR) 요약

  • FR-1: {{PLANNING_FR_1}}
  • FR-2: {{PLANNING_FR_2}}
  • FR-3: {{PLANNING_FR_3:필요 없으면 삭제}}
  • FR-4: {{PLANNING_FR_4:필요 없으면 삭제}}

비기능 요구사항 (NFR) 요약

  • NFR-1: {{PLANNING_NFR_1}}
  • NFR-2: {{PLANNING_NFR_2:필요 없으면 삭제}}

이월된 오픈 질문 / 리스크

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

  • {{DEFERRED_ITEM_1:없으면 "없음"}}
  • {{DEFERRED_ITEM_2:필요 없으면 삭제}}

2. 작업 분해 (Task Breakdown)

FR/NFR 각각을 실행 가능한 단위 태스크로 분해한다. 각 태스크는 하나의 완료 조건을 가져야 한다.

ID 태스크 제목 유형 참조 요구사항 의존 태스크 담당자
T-1 {{TASK_TITLE_1}} {{TASK_TYPE_1:개발|문서|검토|설계|운영}} {{TASK_REF_1:FR-1}} - {{TASK_OWNER_1:TBD}}
T-2 {{TASK_TITLE_2}} {{TASK_TYPE_2:개발|문서|검토|설계|운영}} {{TASK_REF_2:FR-2}} {{TASK_DEP_2:-}} {{TASK_OWNER_2:TBD}}
T-3 {{TASK_TITLE_3:필요 없으면 삭제}} {{TASK_TYPE_3:개발|문서|검토|설계|운영}} {{TASK_REF_3}} {{TASK_DEP_3:-}} {{TASK_OWNER_3:TBD}}
T-4 {{TASK_TITLE_4:필요 없으면 삭제}} {{TASK_TYPE_4:개발|문서|검토|설계|운영}} {{TASK_REF_4}} {{TASK_DEP_4:-}} {{TASK_OWNER_4:TBD}}

태스크 완료 조건 (DoD)

각 태스크의 완료 기준을 명시한다.

  • T-1: {{TASK_DOD_1}}
  • T-2: {{TASK_DOD_2}}
  • T-3: {{TASK_DOD_3:필요 없으면 삭제}}
  • T-4: {{TASK_DOD_4:필요 없으면 삭제}}

3. 공수 추정

각 태스크의 예상 공수를 적는다. 단위는 팀 기준에 맞게 선택한다(SP 또는 시간).

ID 태스크 제목 추정 공수 추정 단위 비고
T-1 {{TASK_TITLE_1}} {{EFFORT_1}} {{EFFORT_UNIT:SP|시간|일}} {{EFFORT_NOTE_1:필요 없으면 삭제}}
T-2 {{TASK_TITLE_2}} {{EFFORT_2}} {{EFFORT_UNIT}} {{EFFORT_NOTE_2:필요 없으면 삭제}}
T-3 {{TASK_TITLE_3:필요 없으면 삭제}} {{EFFORT_3}} {{EFFORT_UNIT}} {{EFFORT_NOTE_3:필요 없으면 삭제}}
T-4 {{TASK_TITLE_4:필요 없으면 삭제}} {{EFFORT_4}} {{EFFORT_UNIT}} {{EFFORT_NOTE_4:필요 없으면 삭제}}
  • 총 추정 공수: {{TOTAL_EFFORT}}
  • 추정 신뢰도: {{EFFORT_CONFIDENCE:High|Medium|Low}}
  • 추정 근거: {{EFFORT_BASIS:추정에 사용한 방법 또는 유사 사례}}

4. 일정 계획

이터레이션 또는 스프린트 단위로 태스크 배분 계획을 적는다.

마일스톤

마일스톤 목표 날짜 포함 태스크 완료 조건
M-1: {{MILESTONE_1_NAME}} {{MILESTONE_1_DATE:TBD}} {{MILESTONE_1_TASKS:T-1, T-2}} {{MILESTONE_1_DONE}}
M-2: {{MILESTONE_2_NAME:필요 없으면 삭제}} {{MILESTONE_2_DATE:TBD}} {{MILESTONE_2_TASKS}} {{MILESTONE_2_DONE}}

이터레이션 계획

  • 이터레이션 단위: {{ITERATION_UNIT:스프린트|주|없음(단일 배포)}}
  • 이터레이션 1 ({{ITERATION_1_PERIOD:날짜 범위 또는 TBD}}): {{ITERATION_1_TASKS:T-1, T-2}}
  • 이터레이션 2 ({{ITERATION_2_PERIOD:날짜 범위 또는 TBD}}): {{ITERATION_2_TASKS:T-3, T-4}}

5. 의존성 및 제약

태스크 간 의존 관계와 외부 의존성을 기록한다.

태스크 간 의존성

  • {{TASK_DEPENDENCY_1:예. T-2는 T-1 완료 후 시작 가능}}
  • {{TASK_DEPENDENCY_2:필요 없으면 삭제}}

외부 의존성

다른 팀, 시스템, 도구에 의존하는 항목을 적는다.

  • {{EXTERNAL_DEP_1:예. CI/CD 파이프라인 설정 필요}}
  • {{EXTERNAL_DEP_2:필요 없으면 삭제}}

기술/환경 제약

  • {{TECH_CONSTRAINT_1}}
  • {{TECH_CONSTRAINT_2:필요 없으면 삭제}}

6. 검증 계획 개요

Discovery의 성공 기준과 연결해 어떻게 검증할지 초안을 적는다. 상세 검증은 Verification 단계에서 정의한다.

성공 기준 검증 방법 초안 담당자
{{VERIFY_CRITERIA_1:S-1 요약}} {{VERIFY_METHOD_1}} {{VERIFY_OWNER_1:TBD}}
{{VERIFY_CRITERIA_2:S-2 요약}} {{VERIFY_METHOD_2}} {{VERIFY_OWNER_2:TBD}}
{{VERIFY_CRITERIA_3:S-3 요약 또는 삭제}} {{VERIFY_METHOD_3}} {{VERIFY_OWNER_3:TBD}}

7. 리스크

Planning 단계에서 새로 식별된 리스크를 기록한다. Discovery에서 이월된 리스크는 # 1 이월 항목에서 확인한다.

리스크

  • R-1 ({{PLAN_RISK_LEVEL_1:High|Medium|Low}}): {{PLAN_RISK_1}}
    • 완화 방안: {{PLAN_MITIGATION_1}}
  • R-2 ({{PLAN_RISK_LEVEL_2:High|Medium|Low}}): {{PLAN_RISK_2:필요 없으면 삭제}}
    • 완화 방안: {{PLAN_MITIGATION_2:필요 없으면 삭제}}

가정

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

  • PA-1: {{PLAN_ASSUMPTION_1}}
  • PA-2: {{PLAN_ASSUMPTION_2:필요 없으면 삭제}}

오픈 질문

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

  • OQ-1: {{PLAN_OPEN_QUESTION_1}}
    • 상태: {{PLAN_OQ_STATUS_1:Open|Answered|Deferred|Dropped}}
    • 처리 방안: {{PLAN_OQ_ACTION_1}}
    • 종료 조건: {{PLAN_OQ_EXIT_1}}
  • OQ-2: {{PLAN_OPEN_QUESTION_2:필요 없으면 삭제}}
    • 상태: {{PLAN_OQ_STATUS_2:Open|Answered|Deferred|Dropped}}
    • 처리 방안: {{PLAN_OQ_ACTION_2}}
    • 종료 조건: {{PLAN_OQ_EXIT_2}}

8. Design으로 넘기기 전 확인 체크

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

  • 전체 태스크 목록 확정 및 담당자 지정
    • 기준: {{CHECK_TASKS_CRITERIA:모든 태스크에 담당자가 지정되어야 한다}}
  • 공수 추정 완료 및 총 공수 확인
    • 기준: {{CHECK_EFFORT_CRITERIA:모든 태스크의 추정 공수가 채워져야 한다}}
  • 마일스톤 및 이터레이션 계획 확정
    • 기준: {{CHECK_SCHEDULE_CRITERIA:M-1 이상의 마일스톤과 이터레이션 경계가 정의되어야 한다}}
  • 외부 의존성 해소 계획 확인
    • 기준: {{CHECK_DEP_CRITERIA:외부 의존성 각 항목에 담당자 또는 해소 방안이 있어야 한다}}
  • 모든 오픈 질문(OQ) Open 상태 없음 확인
    • 기준: OQ 목록에 Open 상태 항목이 0개이거나, 잔여 항목 전부 Deferred 처리 완료
  • Freeze 확정 담당자(CONFIRMED_BY) 지정
    • 기준: {{CHECK_CONFIRMEDBY_CRITERIA:문서 승인 또는 인계 결정을 내릴 담당자가 명시되어야 한다}}

9. 파일 처리 결과

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

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

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

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

DECIDE

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

CONFIRM

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

DATA

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

11. Planning Freeze

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

섹션 참조

Freeze 플래그

  • Handoff Decision: {{FREEZE_HANDOFF_DECISION:Design 진행 가능|보류}}
  • Handoff Rationale: {{FREEZE_HANDOFF_RATIONALE:진행 가능 또는 보류 판단 근거 1-2줄}}
  • Ready for Design: {{READY_FOR_DESIGN:false}}
  • Confirmed By: {{CONFIRMED_BY:TBD}}
  • Confirmed At (KST): {{CONFIRMED_AT_KST:TBD}}

12. 작성 가이드

템플릿 사용 시의 기본 규칙을 적는다. 실제 문서를 만들 때는 이 가이드를 기준으로 플레이스홀더를 치환한다.

  • 이 파일은 템플릿이다. 실제 문서 작성 시 {{...}} 플레이스홀더를 구체 값으로 교체한다.
  • 필요 없는 태스크/마일스톤 행은 삭제하고, 부족한 항목은 같은 형식으로 추가한다.
  • 공수 추정은 팀 기준 단위(SP/시간/일)를 통일해서 사용한다.
  • Planning Freeze는 문서 하단에 반드시 유지한다.
Reference in New Issue View Git Blame Copy Permalink