feat: add update script and operations docs/templates

This commit is contained in:
2026-04-14 22:02:39 +09:00
parent 974c3d0dbd
commit edf7e61a44
8 changed files with 359 additions and 55 deletions
+10 -2
View File
@@ -38,13 +38,21 @@ bash .github/tools/calc_priority_scores.sh .github/templates/planning-backlog-sc
- .github/runbooks/services/web.rollback-runbook.md
3. 배포 전 각 서비스 인스턴스의 Trigger/Procedure/Validation 최신화
## 4. Verification Exception Quick Start
## 4. Operations Quick Start
1. 기본 템플릿: .github/templates/operations-note.template.md
2. 생성 프롬프트: /operation-draft rel-001
3. 검토 프롬프트: /operation-review rel-001
4. 승인 프롬프트: /operation-confirm rel-001
5. 산출 경로: docs/sdlc/operations/ops-<3자리문서번호>_YYYY-MM-DD_<topic-slug>.operations.md
## 5. Verification Exception Quick Start
1. Major 결함 예외는 승인자 정책을 따름
2. Valid Until 설정은 만료 전 재검증 필수
3. 만료/해소 상태를 검증 리포트에 반영
## 5. Minimum Go-live Checklist
## 6. Minimum Go-live Checklist
1. 우선순위 점수표 완료
2. 테스트 실행 근거 첨부
+2 -2
View File
@@ -33,8 +33,8 @@ tools: [read, edit, search, todo]
7. 승인 가능 시 아래 순서로 문서를 수정한다:
a. `# 0. 문서 상태`의 상태를 `confirmed`로 변경한다.
b. `# 0. 문서 상태`의 승인 시각을 현재 날짜(YYYY-MM-DD)로 기재한다. `{{CONFIRM:` 형식이 남아 있으면 현재 날짜로 대체한다.
c. `# 7. 파일 처리 결과` 항목에 Operations 완료 시각과 마감 상태를 추가한다.
d. `# 8. 사용자 결정 필요 항목 요약`의 내용을 `현재 미해결 플레이스홀더 없음`으로 대체한다. 기존 `##` 하위 항목은 모두 제거한다.
c. `# 6. 파일 처리 결과` 항목에 Operations 완료 시각과 마감 상태를 추가한다.
d. `# 7. 사용자 결정 필요 항목 요약`의 내용을 `현재 미해결 플레이스홀더 없음`으로 대체한다. 기존 `##` 하위 항목은 모두 제거한다.
8. 환류 항목 처리 규칙:
- `# 5. 다음 반복 환류 항목`에 명시된 각 개선 항목에 대해 다음 Discovery/Planning 백로그 연결을 확인한다.
- 자동으로 연결하지 않으며, 사용자가 수동 등록한 것만 인계 완료로 표시한다.
+4 -3
View File
@@ -24,6 +24,7 @@ tools: [read, edit, search, agent, todo]
- 파일명: ops-<3자리문서번호>_YYYY-MM-DD_<topic-slug>.operations.md
- 문서번호: 기존 ops 번호 최대값 + 1, 없으면 001부터 시작
- 날짜: 생성일 기준, 이후 수정 시 파일명 날짜 유지
- 본문 템플릿: .github/templates/operations-note.template.md
- append 금지, 생성/갱신 시 overwrite
6. Operations 작성 원칙:
- Release의 배포 체크리스트, 롤백 계획, 관찰 계획을 근거로 운영 추적 문맥을 작성한다.
@@ -42,7 +43,7 @@ tools: [read, edit, search, agent, todo]
- 상태: 초안 생성 시 `draft`
- 승인자: Release 문서에서 인계받음
- 승인 시각: `{{CONFIRM: 배포 완료 후 Operations 확인}}`
9. # 6 사용자 결정 필요 항목 요약 규칙:
9. # 7 사용자 결정 필요 항목 요약 규칙:
- 본문의 {{DECIDE}}/{{CONFIRM}}/{{DATA}}를 유형별로 집계한다.
- 미해결 플레이스홀더가 없으면 `현재 미해결 플레이스홀더 없음`으로 작성한다.
@@ -57,7 +58,7 @@ tools: [read, edit, search, agent, todo]
8. Postmortem 섹션 생성 (8개 항목 모두 {{DATA:}} 또는 등급별 예시 포함)
9. 환류 항목 섹션 생성 (발견된 개선 사항 추출 또는 {{DATA:}})
10. Operations 문서 저장
11. 본문 플레이스홀더 집계 후 # 6 작성
11. 본문 플레이스홀더 집계 후 # 7 작성
12. 최종 응답에 처리 요약 제공
Operations 문서 출력 섹션 순서(고정):
@@ -75,7 +76,7 @@ Operations 문서 출력 섹션 순서(고정):
2. 입력 Release 문서 경로
3. Operations 문서 생성/갱신 결과
4. 배포 실행 기록 초안 요약
5. 모니터링 관찰 항목 복사 상여
5. 모니터링 관찰 항목 복사 상세
6. Postmortem 템플릿 완성도
7. 업데이트된 파일 경로 목록
8. 다음 액션 (배포 실행자가 DATA 항목 채우기)
+1 -1
View File
@@ -30,7 +30,7 @@ tools: [read, edit, search, todo]
- 본문에 `{{DATA:` 플레이스홀더가 남아 있으면 미완성으로 표시한다.
6. 정규화 규칙:
- {{DATA:}} 플레이스홀더는 유지하면서, 사용자가 실제 데이터를 작성한 항목은 플레이스홀더 제거
- 모든 섹션이 완성되면 # 7 플레이스홀더를 정리한다
- 모든 섹션이 완성되면 # 7 사용자 결정 필요 항목 요약 정리를 안내한다
- 배포 실행 결과나 Postmortem이 일부 만료되지 않았다면, 진행 중(미완료) 상태 명시 후 진행
7. 응답 규칙:
- 검토 결과를 미충족 항목 목록으로 보고한다 (별도 수정 없음)
@@ -0,0 +1,80 @@
# 0. 문서 상태
- 상태: draft
- 승인자: {{DECIDE: 이 Operations의 최종 승인자는 누구인가?}}
- 승인 시각: {{CONFIRM: 배포 완료 후 Operations 확인}}
# 1. 배포 실행 기록
- 입력 Release: {{DATA: docs/sdlc/release/rel-XXX_YYYY-MM-DD_topic.release.md}}
- 배포 방식: {{DATA: 점진 배포/일괄 배포}}
- 배포 환경: {{DATA: production/staging 등}}
- 배포 창(UTC): {{DATA: 시작/종료 시각}}
## 사전 검증
- 체크리스트 점검 결과: {{DATA: 완료/미완료 항목}}
- 롤백 준비 상태: {{DATA: 준비됨/미준비 + 근거}}
## 실행 결과
- 실행 명령/절차 요약: {{DATA: 실행 로그 요약}}
- 결과: {{DATA: 성공/부분성공/실패}}
- 영향 범위: {{DATA: 사용자/시스템 영향}}
## 배포 직후 검증 결과
- 핵심 시나리오 검증: {{DATA: 통과/실패 + 근거}}
- 예외/알림 발생 여부: {{DATA: 있음/없음 + 내용}}
# 2. 모니터링 관찰 결과
| 모니터링 항목 | 측정 지표 | 정상 범위 | 이상 감지 기준 | 관찰 결과 | 비고 |
|---|---|---|---|---|---|
| {{DATA: 항목명}} | {{DATA: 지표}} | {{DATA: 정상 범위}} | {{DATA: 임계치}} | {{DATA: 결과}} | |
## 관찰 기간
- 집중 관찰 기간: {{DATA: 시작~종료}}
- 일반 관찰 기간: {{DATA: 시작~종료}}
# 3. 인시던트 대응 기록
- 인시던트 발생 여부: {{DATA: 발생/해당없음}}
## 발생한 경우 기록
- 영향도 분류: {{DATA: 사용자/기능/데이터 영향}}
- 타임라인:
- 탐지 시각(UTC): {{DATA: 시각}}
- 대응 시작(UTC): {{DATA: 시각}}
- 완화 시각(UTC): {{DATA: 시각}}
- 복구 완료(UTC): {{DATA: 시각}}
- 커뮤니케이션:
- 채널: {{DATA: 채널}}
- 공지 시각(UTC): {{DATA: 시각}}
- 업데이트 주기: {{DATA: 주기}}
- 우회책 실행 여부: {{DATA: 실행/미실행 + 내용}}
- 복구 절차 요약: {{DATA: 복구 단계}}
# 4. Postmortem
- What Happened: {{DATA: 사건 개요와 사용자 관찰 증상}}
- Impact: {{DATA: 서비스/사용자/비즈니스 영향}}
- Root Cause: {{DATA: 기술적 원인 + 시스템적 원인}}
- Detection: {{DATA: 탐지 경로/지연 요인/알림 품질}}
- Response: {{DATA: 대응 의사결정 및 실행 평가}}
- Recovery: {{DATA: 복구 절차와 검증 결과}}
- Preventive Actions: {{DATA: 재발 방지 액션(담당자/기한 포함)}}
- Follow-up Tracking: {{DATA: Discovery/Planning 백로그 연결 상태}}
# 5. 다음 반복 환류 항목
| 환류 ID | 개선 항목 | 연결 대상(Discovery/Planning) | 담당자 | 목표일 | 상태 |
|---|---|---|---|---|---|
| FB-001 | {{DATA: 개선 항목}} | {{DATA: dcy/pln 문서 또는 티켓}} | {{DATA: 담당자}} | {{DATA: YYYY-MM-DD}} | {{DATA: 등록됨/대기}} |
# 6. 파일 처리 결과
- 생성/갱신 경로: {{DATA: docs/sdlc/operations/ops-XXX_YYYY-MM-DD_topic.operations.md}}
- 입력 Release 경로: {{DATA: docs/sdlc/release/rel-XXX_YYYY-MM-DD_topic.release.md}}
- 처리 결과: {{DATA: 생성/갱신/검토}}
- 비고: {{DATA: 특이사항}}
# 7. 사용자 결정 필요 항목 요약
## {{DECIDE}}
- (없으면 이 섹션 제거)
## {{CONFIRM}}
- (없으면 이 섹션 제거)
## {{DATA}}
- (없으면 이 섹션 제거)