genichin
3a1afaac46
3a72413 Merge pull request #5 from genichin/copilot/add-verification-steps-sdlc-prompt d362b6b feat: add verification stage to run-sdlc pipeline 9b52ae1 Initial plan 893d465 Merge pull request #3 from genichin/copilot/add-sdlc-prompt-feature 57b3941 feat: add /run-sdlc prompt for automated SDLC pipeline execution 27396ab Initial plan 6979011 Clarify draft creation for new SDLC prompts 1c5557b fix(bootstrap): sdlc 디렉토리 구조 단순화 및 summary 템플릿 추가 af343e5 docs(prompt): SDLC 프롬프트 저장소 현황 탐색 및 대조 절차 강화 cc55e06 chore: Release/Operations 프로세스 템플릿 및 프롬프트 추가 및 README 최신화 386695b commit 4533017 draft 82b7690 draft-design 0503411 draft 9984db0 confirm-discovery, draft-planning, review-planning 명령 추가 cba64f0 add confirm-discovery prompt 9391537 draft 58f2de8 feat: execute implementation during run-sdlc flow 693e3f6 feat: auto-create downstream drafts in run-sdlc 404bc63 docs: translate SDLC orchestration prompts to English 9018e8f feat: add SDLC scaffold and sequential run commands d60e21c docs: clarify when to create a new discovery 0629eee feat: add operation issue triage prompt cdc8d87 feat: make update.sh auto-overwrite by default with --no-overwrite option ead06c2 chore: add execute tool to all prompt files git-subtree-dir: .vendor/stage-pilot git-subtree-split: 3a72413acd2edd95053631f900d3c99c1caef359
141 lines
5.4 KiB
Markdown
141 lines
5.4 KiB
Markdown
|
|
# 사용방법
|
|
|
|
## 최초 등록
|
|
|
|
```bash
|
|
# 리모트 등록
|
|
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 .
|
|
```
|
|
|
|
## 업데이트
|
|
|
|
```bash
|
|
# 원격이 등록된 경우(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 문서 세트를 한 번에 생성할 수 있다.
|
|
|
|
```text
|
|
/new-sdlc 결제 실패 알림 정책을 도입한다
|
|
```
|
|
|
|
이 명령은 `dcy/pln/dsn/imp/ver/rel/ops` 문서를 같은 번호로 모두 `draft` 상태로 만든다. 다만 승인 작업은 Discovery부터 순차적으로 진행해야 한다.
|
|
|
|
초안 생성 후 순차 검토/승인을 자동 실행하려면 아래 명령을 사용한다.
|
|
|
|
```text
|
|
/run-sdlc dcy-001 홍길동
|
|
```
|
|
|
|
이 명령은 Discovery부터 Operations까지 순서대로 검토/승인을 시도한다. 이미 승인된 단계는 건너뛰며, 중간 단계에서 승인 불가면 해당 단계에서 멈추고 미충족 항목과 추가 결정사항을 알려준다.
|
|
|
|
### 기본 실행 순서
|
|
|
|
1. Discovery
|
|
2. Planning
|
|
3. Design
|
|
4. Implementation
|
|
5. Verification
|
|
6. Release
|
|
7. Operations
|
|
|
|
### 단계별 명령 예시
|
|
|
|
```text
|
|
# 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`
|
|
|