123 lines
5.3 KiB
Markdown
123 lines
5.3 KiB
Markdown
|
|
---
|
||
|
|
name: bt-c50-token-policy
|
||
|
|
description: BurningTimes 토큰 정책·과도 분량 사전 PD 승인·맥락 분할·병렬 활용 규칙. 큰 작업·다단계 집행·Task 다수 호출·SKILL.md 대규모 갱신·매니페스트 다중 등록 시 자동 로드. 키워드 — 토큰·분량·과도·맥락 분할·병렬·token·context·budget·옵션·분할·간소화·생략·Phase·사전 승인. C50 과도 토큰 사전 PD 승인 + P32 맥락 분할 순차 진행.
|
||
|
|
---
|
||
|
|
|
||
|
|
# BurningTimes 토큰 정책 (L2)
|
||
|
|
|
||
|
|
> 본 SKILL = 큰 작업·다단계 집행·토큰 분량 추정 시 자동 로드.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## C50. 과도한 토큰 소비 사전 PD 승인 의무
|
||
|
|
|
||
|
|
PD 직접 지시 (2026-04-24): "과도한 토큰 소비가 예상될 경우 반드시 PD 확인 + 승인 후 진행".
|
||
|
|
|
||
|
|
### C50-1. 판단 주체와 기준
|
||
|
|
|
||
|
|
- **판단 주체**: PM·팀장 (팀원 아님 — 결과 책임 영역)
|
||
|
|
- **판단 기준**: PM·팀장 자체 판단 (수치 기준 고정 X — 작업 영역·복잡도 따라 가변)
|
||
|
|
- 판단 모호 시 PD 질의 우선 (C36-2 보수 선택)
|
||
|
|
|
||
|
|
### C50-2. 사전 승인 보고 의무
|
||
|
|
|
||
|
|
"과도하다" 판정 시 PD에게 다음 보고 후 승인 대기:
|
||
|
|
|
||
|
|
1. **추정 분량** — 응답 토큰·도구 호출 횟수·시간
|
||
|
|
2. **분할 옵션** — 작업을 N단계로 분할 가능 여부
|
||
|
|
3. **간소화 옵션** — 작업 범위 축소 가능 여부
|
||
|
|
4. **생략 옵션** — 일부 산출물 생략·후속 분리 가능 여부
|
||
|
|
|
||
|
|
→ PD 결정 후 진행 (분할·간소화·생략·그대로 PD 결정).
|
||
|
|
|
||
|
|
### C50-3. Task 위임 시 토큰 추정 권고
|
||
|
|
|
||
|
|
Agent Task 위임 프롬프트 작성 시 **예상 토큰량 1줄 추정** 기재 권고 (의무 아님):
|
||
|
|
- 위임 영역·산출물 분량·도구 호출 횟수 기반 추정
|
||
|
|
- 추정이 과도 영역 진입 시 본 룰 적용
|
||
|
|
|
||
|
|
### C50-4. 위반 시
|
||
|
|
- 자체 판단 폭주 진행 = 위반
|
||
|
|
- 1차: 자진 고지 + 사후 PD 안내
|
||
|
|
- 반복: 역할 재검토
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## P32. 내부 계획 맥락 분할·순차 진행 원칙
|
||
|
|
|
||
|
|
> "**계획을 무조건 단순하게 하라는 의미가 아니라 너무 긴 계획을 주요 맥락으로 나눠서 순차적으로 진행하라는 의미**" — PD 재정의
|
||
|
|
|
||
|
|
### P32-1. 핵심 원칙
|
||
|
|
- **전체 계획은 설계 문서로 유지** (P18 준수)
|
||
|
|
- **집행 단계는 주요 맥락 단위로 분할** — 각 맥락 = 독립 검증 가능 단위
|
||
|
|
- **맥락 간 전환 시 진척 보고 + 필요 시 PD 순차 질의**
|
||
|
|
- **단일 응답에 전체 계획 실행 금지** (장시간 스트리밍 유발)
|
||
|
|
|
||
|
|
### P32-2. 적용 범위
|
||
|
|
- PD 직접 지시 외 PM·팀장 자체 판단 복잡 과제
|
||
|
|
- 설계·구현·시뮬·검증·리팩토링 등 다단계 집행
|
||
|
|
- 장시간 연속 응답 예상 작업
|
||
|
|
- 서브에이전트 Task 프롬프트 작성 시 — 단일 Task 범위 과도 시 Phase 분할
|
||
|
|
|
||
|
|
### P32-3. 맥락 분할 규약
|
||
|
|
- 각 맥락은 **독립 집행 가능** — 선행 실패 시 후행 재평가
|
||
|
|
- 맥락 간 **의존 관계 명시** ("Phase A 완료 후 Phase B 착수")
|
||
|
|
- 맥락 전환 시 **상태 공유** (`.live/`·대화로그·PD 지시 로그)
|
||
|
|
- 맥락 크기 권장: **단일 응답 내 완결 가능 범위** (C14-6 Chunk 분할 연계)
|
||
|
|
|
||
|
|
### P32-4. C29 업무 자율 수행과의 경계
|
||
|
|
|
||
|
|
**P32 허용 질의 유형**:
|
||
|
|
- 맥락 간 **선택지 병존** 시 (A안·B안·C안 PD 택)
|
||
|
|
- **범위 경계 애매** 시
|
||
|
|
- **방향 검증** 필요 시 (중간 결과 기반 경로 수정)
|
||
|
|
- **PD 결정 영역(C36-2)** 안건 상신
|
||
|
|
|
||
|
|
**P32 금지 질의 (C29-2 위반)**:
|
||
|
|
- 팀장 재량 가능 사안 떠넘기기
|
||
|
|
- 무계획 "어떻게 할까요?" 단순 질의
|
||
|
|
- 책임 회피성 승인 요청
|
||
|
|
|
||
|
|
### P32-5. 전체 계획 유지 의무
|
||
|
|
- 맥락 분할이 **P18 설계 문서화 회피**로 변질 X
|
||
|
|
- 전체 설계는 별도 문서 유지 (예: `Phase4_설계_v1.md` 전 섹션 작성 후 Phase A·B·C 분할 집행)
|
||
|
|
- 맥락 분할은 **집행 방식**이지 설계 축소 아님
|
||
|
|
|
||
|
|
### P32-6. 실행 예시
|
||
|
|
|
||
|
|
**잘못된 적용** (계획 축소 변질):
|
||
|
|
- 설계 문서 "간략히 5섹션만"으로 압축 → C10-5·P18 위반
|
||
|
|
- "복잡한 건 다음에"로 미루기 → 책임 회피
|
||
|
|
|
||
|
|
**올바른 적용** (맥락 분할):
|
||
|
|
- 설계 문서 전 섹션 완비 → Phase A(기반) 단일 Task → 완료 보고 → Phase B(판정) 단일 Task → 완료 보고 → Phase C(실행) 단일 Task
|
||
|
|
- 각 Phase 전환 시 PD 상황 공유 + 필요 시 방향 확인
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 운영 팁
|
||
|
|
|
||
|
|
### 작업 추정 가이드
|
||
|
|
| 작업 유형 | 추정 토큰 | 분할 권고 |
|
||
|
|
|---------|---------|---------|
|
||
|
|
| 단일 SKILL 작성 (~5K 본문) | ~5-7K | 단독 응답 가능 |
|
||
|
|
| 다중 SKILL 5개 일괄 | ~25-35K | 응답 1-2개 분할 권고 |
|
||
|
|
| SKILL.md 전면 갱신 (3000줄) | ~50-100K | C14-6 Chunk 분할 + Phase 분리 |
|
||
|
|
| 14 agent frontmatter 일괄 | ~10-20K | 매니페스트 1개 통합 가능 |
|
||
|
|
| Hook 신설 4종 + 검증 | ~15-25K | Phase 단위 분할 권고 |
|
||
|
|
|
||
|
|
### 분할 시 의무
|
||
|
|
- Phase별 **PD 진척 보고**
|
||
|
|
- Phase 종료 시 **다음 Phase 안내**
|
||
|
|
- 차단 발생 시 **즉시 자진 고지**
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 연관 규칙
|
||
|
|
|
||
|
|
- **L1**: C9 일정 표현 금지·C42 사전 검증·C44 팩트 우선 (`bt-foundation`)
|
||
|
|
- **C14**: 토큰 최소화 우선 설계 (`bt-document-mgmt`)
|
||
|
|
- **C20-2**: PD 사전 확인 우려 이슈 (`bt-commit-rules`)
|
||
|
|
- **C36**: PM 자율 판단 상한 (`bt-foundation`)
|
||
|
|
- **C48·C49**: Task 배제·표준 프로세스 (`bt-task-delegation`)
|