BurningTimesAi/.claude/skills/bt-archive-mgmt/SKILL.md

5.0 KiB

name description
bt-archive-mgmt BurningTimes 아카이브·폐기·승격·이동 규칙. 규칙 폐기·통합·강등·승격·아카이브 이관·외부 SOT 참조 시 자동 로드. 키워드 — 아카이브·archive·폐기·deprecation·강등·승격·통합·이관·이력·history·외부 SOT. C14-5 본문 최신 + 히스토리 아카이브 + C37-6 변경 아카이브 의무 + 폐기 규칙 아카이브 SOT.

BurningTimes 아카이브 관리 규칙 (L2)

본 SKILL = 규칙·문서·산출물 폐기·이관·아카이브 작업 시 자동 로드.


C14-5. 본문 최신 + 히스토리 아카이브 원칙

모든 문서(고정비·변동비)는 본문에 최신 내용만. 작업 과정 히스토리·방향 전환·"당시 가정"은 외부 아카이브.

구조

  1. 본문 — 최신 내용만
    • "당시 가정 vs 현 방향" 병기 금지
    • 상단 배너로 방향 전환 이력 표시 금지 (본문 읽기 방해)
  2. 외부 아카이브 SOT 2종:
    • 공유/조직공지/폐기_규칙_아카이브.md — C·P 규칙 폐기·개정 이력
    • 공유/조직공지/방향전환_히스토리_아카이브.md — 프로젝트·설계·기획 방향 전환
  3. 문서 말미 참조 섹션 1줄 링크- 방향 전환 이력: [방향전환 히스토리 아카이브](공유/조직공지/방향전환_히스토리_아카이브.md#대상_섹션)

집행 시 3종 세트 동시 수행

  • (ㄱ) 본문 수정 (최신 내용만)
  • (ㄴ) 아카이브 파일에 "당시 가정 → 현 방향" 6필드 형식 기록
  • (ㄷ) 본문 말미 참조 섹션에 아카이브 링크 1줄 추가 (상단 배너 금지)

예외 — 파일 성격 배너는 유지

다음 2종은 파일 자체의 성격을 표시하므로 상단 유지:

  • 아카이브된 문서 자체 (예: 07_*.md 상단 "🔴 아카이브됨 — 대체: X" 배너 + 본문 당시 그대로)
  • 완료 실적 문서 (예: 특정 단계 완결 후 "🟢 완료 실적 아카이브" 배너로 전환)

C14-5-확장. 폐기·통합·강등 조항 본문 완전 삭제

폐기·통합·강등된 C/P 규칙은 SKILL.md·CLAUDE.md 본문에서 완전 삭제 + 아카이브 파일에만 기록.

핵심 원칙

  • ~~C7~~ (P30 강등)·~~C8~~ (C6 통합)·~~P24~~ (C32 승격) 같은 1줄 폐기 표기도 남기지 않음
  • 번호 구멍 허용 — 예: C6 → 바로 C9 (C7·C8 자리 공백, 폐기 표기 없음)
  • 번호 체계 연속성은 자산 아님 — 조직 기억은 아카이브 SOT가 담당
  • 활성 본문은 현재 유효 규칙만 나열하여 가독성·토큰 효율 극대화

재발 방지 장치 — 3종 세트

향후 규칙 폐기·통합·강등 시:

  • (ㄱ) 본문 섹션 완전 삭제 (~~취소선~~ 표기조차 금지)
  • (ㄴ) 아카이브 파일에 6필드 기록 (규칙번호·신설·폐기·상태·대체·경위)
  • (ㄷ) CLAUDE.md 요약 블록에서도 폐기 항목 완전 제거 (아카이브 링크 1줄로 대체)

예외

현행 규칙 내부에서 폐기된 조항 자체를 선언하는 본문(예: "P20 폐기 → C32 대체"를 설명하는 C32 본문 내 역사 서술)은 허용. 이는 현행 규칙의 맥락 설명.


C37-6. 변경 아카이브 의무

규칙 통합·이동·폐기 시 공유/조직공지/폐기_규칙_아카이브.md에 6필드 기록:

필드 설명
1. 규칙 번호 C·P
2. 변경일 YYYY-MM-DD
3. 변경 전 상태 본문 요지·위치·적용 대상
4. 변경 후 상태 신 위치·참조·축소 내용·대체 규칙
5. 사유 중복·배치·통합·폐기·승격
6. 경위 PD 지시·pm-auditor 감사·PM 재량

외부 아카이브 SOT 2종

공유/조직공지/폐기_규칙_아카이브.md

  • C·P 규칙 폐기·통합·강등 영구 기록
  • 6필드 형식 일관 유지
  • 신규 폐기 시 즉시 추가

공유/조직공지/방향전환_히스토리_아카이브.md

  • 프로젝트·설계·기획 방향 전환 이력
  • "당시 가정 → 현 방향" 형식
  • 헌법 제1원칙 ② "경험 축적·계승" 정합

PD 지시 로그 완료 아카이브 이동

P19 운영 영역. bt-pd-tracking SKILL 참조.

핵심 원칙

  • 활성 → 완료 아카이브 이동 시 즉답 접두 포함
  • 형식: [완료: YYYY-MM-DD HH:MM · commit: {hash} · 참조: {대화로그}]
  • 4W 답변 가능 보장

매니페스트 archived 이동

scripts/manifest_archive.sh post-commit hook 자동 처리:

  • commit 직후 active 매니페스트 → archived 이동
  • target_files cross-check (commit diff vs 매니페스트 범위)
  • 범위 축소 조작 감지

push 직전 매니페스트는 commit 안 하므로 자동 archive X. 수동 mv 또는 다음 commit 시 archive.


연관 규칙

  • L1: C32 대화로그·C37 규칙 문서 관리 (bt-foundation)
  • C26: 코어룰 단일 SOT 갱신 (bt-document-mgmt)
  • C37-1·C37-3: 중복 금지·참조 무결성 (bt-document-mgmt)
  • P19 완료 아카이브: bt-pd-tracking