BurningTimesAi/.claude/skills/bt-c50-token-policy/SKILL.md

5.3 KiB

name description
bt-c50-token-policy 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)