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

4.5 KiB

name description
bt-data-protection 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)