7.8 KiB
| name | description |
|---|---|
| bt-document-mgmt | BurningTimes 문서 관리·SKILL.md·CLAUDE.md·규칙 변경·아카이브 인용·번호 정합·참조 무결성 규칙. 규칙 신설·문서 수정·SKILL.md 갱신·CLAUDE.md 갱신·번호 매기기·아카이브 참조·설계 문서 작성 시 자동 로드. 키워드 — SKILL.md·CLAUDE.md·규칙 변경·문서 수정·번호 매기기·넘버링·참조·아카이브·설계 문서·design doc·rule. C14 토큰 최소화 + C22 용어 일관 + C25 넘버링 + C26 코어룰 단일 SOT 갱신 + C37 규칙 문서 관리 + P18 설계 문서화 의무. |
BurningTimes 문서 관리 규칙 (L2)
본 SKILL = 문서·규칙·SKILL.md·CLAUDE.md 관련 작업 시 자동 로드.
C14. 토큰 최소화 우선 설계 원칙
모든 업무는 항상 토큰을 최소화할 수 있는 최적의 설계를 가장 우선적으로 지향.
C14-1. CLAUDE.md 통합 금지
조직 공용 코어룰·프로젝트 룰 수준만 상위 CLAUDE.md 유지. 팀별 에이전트 정의·메모리·작업 노하우는 각 팀의 .claude/ 하위 또는 memory 파일 분리, 필요 시에만 참조.
C14-2. 고정비·변동비 분리 설계
| 범주 | 정의 | 예시 |
|---|---|---|
| 고정비 | 매 턴 강제 로드 | CLAUDE.md, MEMORY.md 인덱스 |
| 변동비 | 필요 시 on-demand 참조 | memory/*.md 개별, 프로젝트 숙지 문서 |
C14-3. 고정비 증가는 PD 승인 사항
CLAUDE.md 신규 항목·매 턴 로드 대상 확대·MEMORY.md 인덱스 확장 등 고정비 증가는 PD 승인 후에만.
C14-4. 참조 무결성 원칙
하위 CLAUDE.md는 상위 CLAUDE.md 내용을 중복 기재 X 참조 링크만. 동일 규칙 2곳 이상 중복 = C5(정직성) 위반.
C14-5. 본문 최신 + 히스토리 아카이브
모든 문서(고정비·변동비)는 본문에 최신 내용만. 작업 과정 히스토리·방향 전환 이력·"당시 가정"은 외부 아카이브 집약.
구조
- 본문 — 최신 내용만. "당시 가정 vs 현 방향" 병기 금지. 상단 배너로 방향 전환 이력 표시 금지
- 외부 아카이브 SOT 2종:
공유/조직공지/폐기_규칙_아카이브.md— C·P 규칙 폐기·개정공유/조직공지/방향전환_히스토리_아카이브.md— 프로젝트·설계·기획 방향 전환
- 문서 말미 참조 섹션에 1줄 링크
C14-5-확장. 폐기·통합·강등 조항 본문 완전 삭제
~~C7~~ (P30 강등)·~~C8~~ (C6 통합)같은 1줄 폐기 표기도 남기지 않음- 번호 구멍 허용 — 예: C6 → C9 (C7·C8 자리 공백, 폐기 표기 없음)
- 활성 본문은 현재 유효 규칙만 나열
C14-6. 대용량 파일 편집 전술 — 스크립트·Chunk 분할
API Stream idle timeout 방지 + 응답 속도 + 토큰 낭비 차단.
C14-6-1. 스크립트 기반 편집 우선
200줄 초과 또는 10KB 초과 일부 수정 시 Python/Bash 스크립트로 정규식·특정 라인 교체 우선. dry-run 출력 선행 의무.
C14-6-2. Chunk 분할 저장 (대용량 신규 작성)
수백 줄 이상 신규 파일 시 200줄 내외 Chunk로 분할 Edit append 반복. 원본 1회 백업.
C14-6-3. 적용 면제
- 50줄 미만 신규·200줄 미만 기존
- 단일 트랜잭션 필수 (.json·.cs·.py 구조 무결성)
- 짧은 md 1~3줄 수정
C22. 용어·식별자 일관 사용
PD가 사용한 용어·식별자(Phase·단계·안·번호·파일명·변수명)를 임의 변경하거나 다른 체계 재매핑 X.
금지
- PD 도입 용어("Phase 1~4")를 "A/B/C/D"로 재매핑
- 동일 안건·파일·객체에 응답마다 다른 이름
- 사용자 정의 명명의 임의 축약·변형
허용
- PD 명시 새 용어 도입·변경 지시
- 공식 표준 용어 별도 존재 시 — 괄호 병기 ("Phase 3(실시간 알림)")
C25. 제안 넘버링 일관 규칙
조직 내 모든 제안·선택지·목록은 4단 위계 고정 넘버링.
C25-1. 고정 위계 (선순 적용)
| 깊이 | 기호 | 예시 |
|---|---|---|
| 1순위 | 1. 2. 3. 4. |
1. 첫째 안건 |
| 2순위 | 1) 2) 3) 4) |
1) 첫째 하위 |
| 3순위 | A. B. C. D. |
A. 첫째 세부 |
| 4순위 | 가) 나) 다) 라) |
가) 첫째 최하위 |
C25-2. 4순위 초과 시
하이픈·숫자 부가: 1-1. 1-2. 또는 1-1 1-2
C25-3. 금지 표현
①② ③ ④원문자 (헌법 1원칙 5개 식별자만 예외)★ ▶ ●불릿 단독 위계- 순서 건너뛰기 (1순위에서 바로 3순위)
- 임의 식별자 (
α β γ δ·옵션1 옵션2)
C26. 코어룰 단일 SOT 갱신 원칙
핵심 규칙(C)·프로젝트 규칙(P) 추가·변경·삭제 시 .claude/skills/BurningTimes-코어룰/SKILL.md 한 곳만 갱신.
(Skill 패킹으로 부서 서브에이전트·메인 세션 자동 주입)
C26-2. 갱신 요령
- SKILL.md 본문에 신규 조항 추가·기존 수정·삭제
- SKILL.md frontmatter
description"C1~C26" 레이블 갱신 (선택) - 단일 커밋으로 push
C26-3. 위반 시
- SKILL.md 외 다른 곳 코어룰 본문 동시 수정 → 중복 SOT 발생, 즉시 단일화
- SKILL.md 갱신 후 부서 세션 인지 못 하면 → 영속 대화 종료·재resume
C37. 규칙 문서 관리 원칙
C37-1. 중복 금지 의무
동일 개념 2곳 이상 본문 정의 금지. 중복 감지 시:
- 최신 위치 1개 통합 (C14-5 정신)
- 나머지는 참조 링크 전환 ("상세: C21-① 참조")
- 통합 시 의미 보존 최우선
C37-2. 의미 보존 의무
규칙 통합·축소·이동 시:
- 원 규칙 외연·적용 대상·예외 조항 전수 보존
- 의미 축소는 PD 명시 승인 필수 (C36-2 연계)
C37-3. 참조 무결성 의무
규칙 삭제·이동·번호 변경 시:
- 외부 참조 전수 Grep (memory·agent·조직공지·대화로그·PD 지시 로그·스크립트)
- 깨지는 참조 식별 → 갱신 계획 → 동시 집행
C37-4. 표기법 통일
규칙 번호
- 코어룰:
C{번호}(C1·C2·...·Cn) - 프로젝트 룰:
P{번호} - 하위 조항:
C{번호}-{하위}(C2-1·...) - 번호 구멍 허용 (폐기 번호 재사용 금지)
섹션 제목
## C{번호}. {제목} ({신설·개정 일시·근거})
C37-5. 순서 정렬 의무
규칙 추가·변경 시 번호 순서대로 본문 배치 (C1→C2→...→Cn).
C37-6. 변경 아카이브 의무
규칙 통합·이동·폐기 시 공유/조직공지/폐기_규칙_아카이브.md에 6필드 기록:
- 규칙 번호
- 변경일
- 변경 전 상태
- 변경 후 상태
- 사유
- 경위
C37-7. 최신 상태 유지 — 3중 전파
규칙 변경 시 C10-6 3중 전파:
- SKILL.md 본문 갱신 (단일 SOT)
- CLAUDE.md 핵심 규칙 요약 갱신
- pm-auditor·dev-auditor·plan-auditor agent 파일 관련 체크 갱신
P18. 설계 문서화 의무
"설계에 해당하는 결정사항은 반드시 문서로 명문화". 참조만 되고 본문 부재 = 유령 문서 금지.
의무 사항
- 설계 단계 결정사항은 반드시 별도 문서
- 타 문서에서 참조된 설계 문서는 실제 파일 존재
- 참조 시점 미존재 시: 즉시 작성 / "작성 예정" 명시 / 참조 제거
- 설계 변경·대체 시 신규 설계안 문서 필수 작성
설계 문서 필수 포함
- 결정 배경 (왜 필요한가)
- 선택된 방향과 대안 (trade-off)
- 구현 가이드라인
- 검증 방법
- 변경 이력
연관 규칙
- L1: C5 정직성·C42 사전 검증·C44 팩트 우선 (
bt-foundation) - C28: 문서 수정 무승인 (
bt-commit-rules) - C50: 토큰 사전 PD 승인 (
bt-c50-token-policy) - C14-5·C14-6 외부 아카이브:
bt-archive-mgmt