사용방법

최초 등록

# 리모트 등록
git remote add stage-pilot https://github.com/genichin/stage-pilot.git
# subtree 추가
git fetch stage-pilot main
git subtree add --prefix=.vendor/stage-pilot stage-pilot main --squash
# 설치
bash .vendor/stage-pilot/bootstrap/install.sh .

업데이트

# 원격이 등록된 경우(stage-pilot remote 우선 사용)
bash .vendor/stage-pilot/bootstrap/update.sh .

# 충돌 파일을 보존하고 싶을 때(덮어쓰기 비활성화)
bash .vendor/stage-pilot/bootstrap/update.sh --no-overwrite .

# 원격 없이 URL로 직접 업데이트
bash .vendor/stage-pilot/bootstrap/update.sh --repo-url https://github.com/genichin/stage-pilot.git .

# 설치 재적용 없이 subtree만 갱신
bash .vendor/stage-pilot/bootstrap/update.sh --skip-install .

SDLC 프롬프트 사용법

.github/prompts/에 단계별 프롬프트가 정의되어 있으며, Copilot Chat에서 /프롬프트이름 인자 형태로 실행한다.

빠른 시작

처음부터 전체 SDLC 초안 세트를 만들고 싶다면 아래 명령으로 같은 번호의 draft 문서 세트를 한 번에 생성할 수 있다.

/new-sdlc 결제 실패 알림 정책을 도입한다

이 명령은 dcy/pln/dsn/imp/ver/rel/ops 문서를 같은 번호로 모두 draft 상태로 만든다. 다만 승인 작업은 Discovery부터 순차적으로 진행해야 한다.

초안 생성 후 순차 검토/승인을 자동 실행하려면 아래 명령을 사용한다.

/run-sdlc dcy-001 홍길동

이 명령은 Discovery부터 Operations까지 순서대로 검토/승인을 시도한다. 이미 승인된 단계는 건너뛰며, 중간 단계에서 승인 불가면 해당 단계에서 멈추고 미충족 항목과 추가 결정사항을 알려준다.

기본 실행 순서

1. Discovery
2. Planning
3. Design
4. Implementation
5. Verification
6. Release
7. Operations

단계별 명령 예시

# Discovery
/new-sdlc 결제 실패 알림 정책을 도입한다
/review-discovery sdlc-001
/confirm-discovery sdlc-001

# Planning
/draft-planning sdlc-001
/review-planning sdlc-001
/confirm-planning sdlc-001

# Design
/draft-design sdlc-001
/review-design sdlc-001
/confirm-design sdlc-001

# Implementation
/draft-implementation sdlc-001
/run-implementation sdlc-001
/review-implementation sdlc-001
/confirm-implementation sdlc-001

# Verification
/draft-verification sdlc-001
/review-verification sdlc-001
/confirm-verification sdlc-001

# Release
/draft-release sdlc-001
/review-release sdlc-001
/confirm-release sdlc-001

# Operations
/draft-operation sdlc-001
/review-operation sdlc-001
/confirm-operation sdlc-001
/operation-triage 문제: 로그인 후 세션 만료 시 특정 브라우저에서 무한 리다이렉트가 발생한다. 증상: 만료된 세션으로 접근하면 /login 과 /callback 사이를 반복 이동한다. 기대 동작: 세션 만료 시 로그인 페이지로 1회 이동하고 재로그인 안내를 보여야 한다. 영향도: Safari 사용자 일부가 서비스 재진입 불가. 재현 조건: Safari 17, 기존 세션 쿠키 보유, rel-001 배포 이후. 관련 문서: rel-001 ops-001

문서 ID 규칙

모든 단계 문서는 동일한 CYCLE_ID를 공유한다.

• CYCLE_ID 형식: sdlc-<3자리>_<YYYYMMDD>_<topic-slug> (예: sdlc-001_20260417_stage-pilot)
• 각 단계 파일: 1_discovery.md ~ 7_operation.md

언제 새 Discovery를 만드는가

운영 중 문제를 발견했을 때는 먼저 /operation-triage로 분류한 뒤 아래 기준으로 판단한다.

operation-triage 판정 결과	상황	새 Discovery 필요 여부	권장 처리
구현 문제	기존 요구사항/설계/검증 기준은 있었는데 구현이 어긋남, 그리고 관련 문서가 confirmed 이후 상태임	필요	corrective change용 Discovery를 새로 만들고 Planning부터 다시 진행
구현 문제	관련 문서가 모두 draft이고 기존 범위 안에서 수정 가능	불필요	기존 Discovery/Design/Implementation/Verification 문서에 흡수
설계·요구사항 누락	기능은 있었지만 예외 시나리오, 비기능 요구, 운영 리스크가 빠짐	필요	누락 요구를 위한 새 Discovery 생성
신규 범위	기존 SDLC 문서에 실질적으로 없는 기능/정책/요구	필요	새 Discovery 생성
운영 보완만 필요	코드/요구 변경 없이 모니터링, 런북, 공지, 절차만 보완	불필요	Operations 문서 보강
판단 보류	관련 문서 부족, 근거 상충, 재현 불충분	보류	정보 보강 후 /operation-triage 재실행
Hotfix 필요	서비스 중단, 데이터 손실, 보안 영향 등 긴급 대응 우선	필요	Hotfix로 즉시 대응 후 후속 Discovery 생성 및 Postmortem 환류

짧은 판단 기준:

1. 완료된 SDLC 결과물을 바꾸는 수정이면 새 Discovery를 만든다.
2. 아직 draft 단계 문서 보정이면 기존 문서에 흡수한다.
3. 운영 문서 보완만 하면 되면 새 Discovery는 만들지 않는다.

참고 파일

1. 시작 가이드: .github/START-HERE.md
2. 단계 규칙: .github/instructions/
3. 프롬프트 정의: .github/prompts/
4. 템플릿: .github/templates/
5. Operations 템플릿: .github/templates/operations-note.template.md
6. 플레이스홀더 가이드: .github/instructions/placeholder-guide.md