BurningTimesAi/.claude/skills/bt-data-protection/SKILL.md

107 lines
4.5 KiB
Markdown

---
name: bt-data-protection
description: BurningTimes 조직 데이터 보호·백업·프로덕션 보호 규칙. 데이터 테이블·xlsm·CSV·JSON·밸런싱 자산 수정·백업·복원·삭제·롤백·프로덕션 빌드·서버 변경 시 자동 로드. 키워드 — 백업·backup·복원·복구·rollback·롤백·데이터·테이블·xlsm·csv·json·프로덕션·production·서버·DB·밸런싱·수치·삭제·delete·remove. C6 데이터 보호 + C19-2 되돌리기 어려운 액션 보수적 해석.
---
# BurningTimes 데이터 보호 규칙 (L2)
> 본 SKILL = 데이터 파일·밸런싱 자산·프로덕션 영향 작업 시 자동 로드.
---
## C6. 데이터 보호 및 프로덕션 보호
운영 빌드·서버·DB·원본 파일·밸런스 자산에 영향을 주는 작업은 **데이터 무결성과 복구 가능성을 최우선** 수행.
### C6-1. 원본 보호
- **원본 파일 임의 삭제 금지** — 삭제 필요 시 팀장 검토 후 판단
- **원본 데이터 변형 전 백업 필수** — 표준 파일명: `{원본명}.bak_{YYYYMMDD_HHMM}.{확장자}`
- **수치 밸런스 파일(xlsm/csv/json) 등 기획 자산은 변경 전 반드시 버전 태그 백업**
- **중요·대규모 변경은 PD 최종 승인 필수**
#### 백업 표준 포맷 예시
```
스테이지_조건.csv
→ 스테이지_조건.csv.bak_20260507_0145.csv
PlayerStats.xlsm
→ PlayerStats.xlsm.bak_20260507_0145.xlsm
```
**금지 표기**:
- `.bak-YYYYMMDDHH` (구식·하이픈 형식)
- `.bak_<unix-timestamp>` (Unix timestamp)
- 백업 없이 원본 직접 덮어쓰기
### C6-2. 프로덕션 보호
- 프로덕션 영향 변경은 **롤백 경로 확보** 상태에서 수행
- 프로덕션 데이터·실기기 빌드 파괴적 명령은 팀장 확인 필수
- 배포·마이그레이션 전 영향 범위 명시 분석
- 서비스 중단 유발 작업은 PD 사전 승인 필수
### C6-3. 복구 불가 작업 — PD 승인 + 고지 의무
복구 경로 없는 작업은 기본 회피하되 **PD 명시 승인**이 있으면 진행 가능.
#### 고지 의무 (사전·사후)
복구 불가능 작업 수행 시 **반드시 다음 4종 정보를 PD에게 사전·사후 고지**:
1. **복구 불가능한 이유** (기술적 근거)
2. **되돌릴 수 없는 범위** (영향 대상·규모)
3. **예상 부작용** (알려진 리스크)
4. **사전 승인 요청** (실행 전) 또는 **사후 영향 보고** (실행 직후)
**고지 누락 시**: C3(이슈 은폐 금지)·C5(정직성) 위반. 자진 보고 + 처분 대기.
**PD 승인 없이 복구 불가 작업 실행 절대 금지** (C19-2 결합).
---
## C19-2. 되돌리기 어려운 액션 보수적 해석
다음 액션은 **승인 경계 해석 최대 보수**. 애매하면 **실행 금지·확인 선행**:
- `main` 브랜치 병합·force push·tag release
- 외부 공개 게시 (PR 머지·공지 발송·외부 전송)
- **영구 삭제·시스템 이관·권한 변경**
- 프로덕션 빌드·배포·서버 상태 변경 (C6-2 결합)
### 위반 시
- 승인 없는 실행 발견 즉시 **자진 보고** + PD 처분 대기 (롤백 / 사후 승인 / 다른 지시)
- 반복 위반 시 **세션 리더 역할 재검토** 자진 상정
- PD가 "결정을 강요당하는 불쾌 경험"을 하시는 것은 조직 운영 신뢰 기반 훼손 — 재발 방지 의무는 **헌법급**
### 예외
- 세션 내부 반복 작업(같은 지시 수행 중 필요 하위 호출)은 지시 수령 시점 승인 포함
- 명백히 실수 잘못 실행된 경로를 **되돌리는 복구 행위**는 C19 대상 외
---
## 작업 영역별 적용 가이드
### 기획 데이터 (밸런싱·테이블·시나리오)
- 백업 의무 우선 — 원본 직접 덮어쓰기 금지
- 변경 사유 commit 메시지 명시
- balance-designer는 본 SKILL 항시 주입 (frontmatter 명시 종속)
### 개발 빌드·서버
- 롤백 경로 확보 후 진행
- 프로덕션 환경 변경 = PD 사전 승인
- C30 git 동기화 점검 선행 의무 (`bt-commit-rules`)
### 데이터 마이그레이션
- 영향 범위 사전 분석 보고
- 단계별 롤백 가능성 명시
- 테스트 환경 검증 후 진행
---
## 연관 규칙
- **L1**: C5 정직성·C9 일정 표현 금지·C42 사전 검증·C44 팩트 우선
- **C20-2**: 데이터 자산 변경은 PD 사전 확인 (`bt-commit-rules`)
- **C30**: git 동기화 작업 전 점검 (`bt-commit-rules`)
- **C39**: 작업 전 시스템 반영 실측 (`bt-foundation`)
- **C50**: 과도 토큰 사전 PD 승인 (`bt-c50-token-policy`)