197 lines
7.8 KiB
Markdown
197 lines
7.8 KiB
Markdown
|
---
|
|||
|
|
name: bt-document-mgmt
|
|||
|
|
description: 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. 본문 최신 + 히스토리 아카이브
|
|||
|
|
|
|||
|
|
**모든 문서(고정비·변동비)는 본문에 최신 내용만**. 작업 과정 히스토리·방향 전환 이력·"당시 가정"은 외부 아카이브 집약.
|
|||
|
|
|
|||
|
|
#### 구조
|
|||
|
|
1. **본문** — 최신 내용만. "당시 가정 vs 현 방향" 병기 금지. **상단 배너로 방향 전환 이력 표시 금지**
|
|||
|
|
2. **외부 아카이브 SOT 2종**:
|
|||
|
|
- `공유/조직공지/폐기_규칙_아카이브.md` — C·P 규칙 폐기·개정
|
|||
|
|
- `공유/조직공지/방향전환_히스토리_아카이브.md` — 프로젝트·설계·기획 방향 전환
|
|||
|
|
3. **문서 말미 참조 섹션에 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. `①② ③ ④` 원문자 (헌법 1원칙 5개 식별자만 예외)
|
|||
|
|
2. `★ ▶ ●` 불릿 단독 위계
|
|||
|
|
3. 순서 건너뛰기 (1순위에서 바로 3순위)
|
|||
|
|
4. 임의 식별자 (`α β γ δ`·`옵션1 옵션2`)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## C26. 코어룰 단일 SOT 갱신 원칙
|
|||
|
|
|
|||
|
|
핵심 규칙(C)·프로젝트 규칙(P) 추가·변경·삭제 시 **`.claude/skills/BurningTimes-코어룰/SKILL.md` 한 곳만** 갱신.
|
|||
|
|
|
|||
|
|
(Skill 패킹으로 부서 서브에이전트·메인 세션 자동 주입)
|
|||
|
|
|
|||
|
|
### C26-2. 갱신 요령
|
|||
|
|
1. SKILL.md 본문에 신규 조항 추가·기존 수정·삭제
|
|||
|
|
2. SKILL.md frontmatter `description` "C1~C26" 레이블 갱신 (선택)
|
|||
|
|
3. 단일 커밋으로 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필드 기록:
|
|||
|
|
1. 규칙 번호
|
|||
|
|
2. 변경일
|
|||
|
|
3. 변경 전 상태
|
|||
|
|
4. 변경 후 상태
|
|||
|
|
5. 사유
|
|||
|
|
6. 경위
|
|||
|
|
|
|||
|
|
### C37-7. 최신 상태 유지 — 3중 전파
|
|||
|
|
규칙 변경 시 C10-6 3중 전파:
|
|||
|
|
1. SKILL.md 본문 갱신 (단일 SOT)
|
|||
|
|
2. CLAUDE.md 핵심 규칙 요약 갱신
|
|||
|
|
3. pm-auditor·dev-auditor·plan-auditor agent 파일 관련 체크 갱신
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## P18. 설계 문서화 의무
|
|||
|
|
|
|||
|
|
**"설계에 해당하는 결정사항은 반드시 문서로 명문화"**. 참조만 되고 본문 부재 = 유령 문서 금지.
|
|||
|
|
|
|||
|
|
### 의무 사항
|
|||
|
|
1. 설계 단계 결정사항은 **반드시 별도 문서**
|
|||
|
|
2. 타 문서에서 참조된 설계 문서는 **실제 파일 존재**
|
|||
|
|
3. 참조 시점 미존재 시: 즉시 작성 / "작성 예정" 명시 / 참조 제거
|
|||
|
|
4. 설계 변경·대체 시 신규 설계안 문서 필수 작성
|
|||
|
|
|
|||
|
|
### 설계 문서 필수 포함
|
|||
|
|
- 결정 배경 (왜 필요한가)
|
|||
|
|
- 선택된 방향과 대안 (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`
|