BurningTimesAi/.claude/skills/bt-pd-tracking/SKILL.md

155 lines
6.4 KiB
Markdown
Raw Normal View History

feat(SKILL 동적 로딩 분할 Phase A~D-3-2): L1+L2 11 SKILL 신설 + 14 agent frontmatter 차등 + Hook 4종 PD 직접 결정 "A 정식 SKILL 분할 진행" 채택 (2026-05-07). PoC 0차 데이터 + 양 팀장 교차 검증 통합. 토큰 효율 ~70-80% 절감 추정. ## 신설 SKILL 11종 L1 헌법급 (1): - bt-foundation: 헌법 1원칙 + C1·C2·C3·C5·C9·C13·C23·C29·C32·C33·C35·C36·C39·C40·C41·C42·C44·C45·C46·C47 L2 메타 (1): - bt-index: SKILL 카탈로그 인덱스 L2 작업 영역 8개: - bt-commit-rules·bt-task-delegation·bt-data-protection·bt-session-mgmt - bt-pd-tracking·bt-document-mgmt·bt-c50-token-policy·bt-archive-mgmt 부서별 1개: - bt-planning-fun (기획팀 P30·P23) ## Agent frontmatter 차등 매핑 (14 agent) - 감사관 3종 (pm·dev·plan-auditor): 모든 SKILL 11종 항시 - 팀장 3종 (개발·서버·클라이언트팀장): bt-foundation+bt-index - 기획팀장: +bt-planning-fun - designer 5종 (content·level·narrative·system·ux): bt-foundation+bt-index+bt-planning-fun - balance-designer: +bt-data-protection (수치 작업 항시 백업 의무) - pm-general: bt-foundation+bt-index ## Hook 4종 신설 (PostToolUse Edit/Write/MultiEdit) - hardboiled_empathy_check.sh (C45 감정 위로 차단) - proactive_inference_check.sh (C47 관습 되묻기 차단) - skill_trigger_audit.sh (false negative 안전망) - c35_obligation_check.sh (의무 호출 영역 감지) ## 잔여 작업 - D-3-3: SKILL.md 슬림화 (별건 사이클) - Phase E-2: 본 worktree merge 후 신설 SKILL 자동 활성화 검증 근거: PoC 0차 데이터 + 양 팀장 권고 통합 + 설계 문서 v1
2026-05-07 00:16:58 +00:00
---
name: bt-pd-tracking
description: BurningTimes PD 지시 트래킹·활성 지시 관리·완료 아카이브 이동·현황 보고 규칙. PD 지시 수령·로그 갱신·진행 상태 변경·완료 처리·현황 보고·세션 갱신 시 자동 로드. 키워드 — PD 지시·활성 지시·트래킹·로그·진행중·대기·보류·완료·아카이브·현황 보고·report·tracking. C27 Agent 호출 후 로그 갱신 + P19 PD 지시 로그 운영 + P28 현황 보고 표준 포맷.
---
# BurningTimes PD 지시 트래킹 규칙 (L2)
> 본 SKILL = PD 지시 로그 관리·완료 아카이브 이동·현황 보고 작업 시 자동 로드.
---
## C27. Agent 호출 완료 시 PM 로그 갱신 확인 의무
Agent 도구로 호출된 서브에이전트가 작업 완료 후 PD 지시 로그 갱신 누락 패턴을 **구조적 차단**.
### C27-1. PM 의무 (Agent 결과 수령 직후)
1. Agent 결과 수령 시 **해당 작업 관련 PD 지시 로그 항목 상태 갱신 즉시 확인**
2. 미갱신 시 PM이 **직접 갱신** (서브에이전트 재호출 불필요)
3. 갱신 시 Live 더미 파일(`.live/`)에도 변경분 기록 (P25)
### C27-2. 서브에이전트 의무
1. PM이 Agent 프롬프트에 **"작업 완료 시 PD 지시 로그 갱신 포함"** 명시
2. 서브에이전트는 작업 완료 응답에 **로그 갱신 수행 여부 명시**
---
## P19. PD 직접 지시 트래킹·공유 의무
PD가 직접 지시한 사항은 **부서가 자체 트래킹하여 PM에게 공유**하는 것이 의무.
### 단일 SOT 위치
- `공유/PD_지시_트래킹/기획팀_PD_지시_로그.md`
- `공유/PD_지시_트래킹/개발팀_PD_지시_로그.md`
### 기록 형식 (필수 컬럼 7종)
| 컬럼 | 설명 |
|------|------|
| # | 일련 번호 |
| 일시 | 지시 받은 일시 (YYYY-MM-DD HH:MM) |
| 지시 요지 | PD 지시 핵심 내용 |
| 처리 상태 | `대기`·`진행중`·`완료`·`보류`·`취소` |
| 산출물 경로 | 완료 시 결과물 파일 경로 |
| 중단 사유 | `보류`·`취소` 시 사유 |
| 사후 조치 | `보류`·`취소` 시 후속 조치 계획 |
### 기록 의무 (시작·진행·완료·중단 모두)
1. **시작 (강화, 2026-04-15)**: 지시 받으면 **응답 작성 전에** 로그 등록을 **첫 작업으로** 수행
2. **진행**: 작업 중 주기적으로 산출물 경로·상태 갱신
3. **완료**: 응답 확정 시 `완료` 상태 + 산출물 경로 + 결과 요지
4. **중단**: `보류`/`취소` 발생 시 사유 + 사후 조치 함께 기록
5. 누락은 C3·C13 위반 — 자진 보고 후 소급 등록
### 금칙 표현
- "PD 추가 지시 대기"·"PD 지시 대기"
- "사실 확인 먼저" (공유 의무 약화 의미)
올바른 상태 분류 3종:
- (a) **진행 중 + 공유 완료**
- (b) **정식 보류** (사유 + 사후 조치 + 재개 트리거)
- (c) **PD 의사결정 안건** (병행 진행 + 안건만 별도 등록)
### 로그 구조 — 활성·아카이브 2분할
- `## 활성 지시`: `대기`·`진행중`·`보류` 항목만
- `## 완료 아카이브`: `완료`·`취소` 항목
세션 갱신(P21) 시 **활성 지시 테이블만** 스캔 → 보고. 완료 잔류 차단.
#### 완료 시 즉시 이동 의무
항목이 `완료`/`취소`로 상태 변경되면 **상태 변경자가 동일 응답 내**에서:
1. 활성 테이블에서 해당 행 **완전 제거**
2. 완료 아카이브에 **즉답 접두 포함 행 추가**
#### 완료 아카이브 즉답 체계 (4W 답변용)
```
[완료: YYYY-MM-DD HH:MM · commit: {short hash} · 참조: {대화로그 경로 + 엔트리 식별자}]
```
3요소:
- **완료 일시**: 전이 시점 (분 단위)
- **commit hash**: 완료 집행 git short hash. 복수 시 `최종 (집행 시작 포함)`
- **참조 경로**: 작업 대화로그 엔트리 경로
`grep "완료: 2026-04-18" 공유/PD_지시_트래킹/*_로그.md` 한 번으로 즉답 가능.
---
## P28. 조직 업무 현황 보고 표준 포맷
PD 또는 상위로 **조직 업무 현황 보고** 시 매 보고마다 형식 동일 = **항상 동일 표준 포맷**으로 팀별 분리 제공.
### P28-1. 필수 섹션 구조 (고정 템플릿)
```markdown
## 조직 업무 현황 (YYYY-MM-DD)
세션 갱신 실측 완료 — 활성 지시 로그 + 최근 대화로그 + Inbox 전수 확인.
### 활성 업무 총 N건 ([진행중 a / 대기 b / 보류 c])
#### 개발팀 (M건)
| # | 요지 | 영향 프로젝트 | 상태 | 재개 트리거 |
| ... | ... | ... | ... | ... |
#### 기획팀 (K건)
| # | 요지 | 영향 프로젝트 | 상태 | 재개 트리거 |
| ... | ... | ... | ... | ... |
### 주요 관찰
1. **자율 착수 가능** N건 — [구체 항목]
2. **PD 결정 대기** N건 — [구체 항목]
3. **차단 블로커** — [구체 항목]
4. **최근 완료 요약** (선택)
### 권고 / PD 안건
- PM 재량 수행 예정
- **PD 결정 필요 안건**
```
### P28-2. 필드 규칙
- **#**: PD 지시 로그 번호. 팀별 별도 채번
- **요지**: 1줄 핵심 (25자 이내 권장)
- **영향 프로젝트** (필수): `EerieVillage` / `BT.Framework` / `조직 공통`. 복수 시 쉼표 구분
- **상태**: 활성 3종만 표기 (`진행중`·`대기`·`보류`)
- **재개 트리거**: 대기·보류 시 필수
- **주요 관찰**: 4 항목 순서 고정. 해당 없으면 "없음" 명시
### P28-3. 팀 분리 원칙
- **개발팀·기획팀 섹션 분리 필수** — 빈 팀도 "활성 없음" 1줄
- 전문 에이전트(designer)·감사관 작업은 **소속 팀에 귀속**
- PM 직접 수행은 "권고" 섹션의 "PM 재량 수행"
### P28-5. 금지 표현
- 매 보고마다 다른 임의 위계
- 상태 외 추가 컬럼 임의 추가
- 완료 아카이브 항목을 활성 표에 포함
### P28-8. 최신 결정 중심 보고 원칙
현황 보고·예상 결과 보고·완료 보고 시 **확정·종결된 안건 불필요 재언급 금지**.
- **최신 결정 중심** 서술
- **"고착·영구 확정·재논의 대상 아님"** 등 재강조 표현은 위험 신호 — 등장 시 삭제 검토
- **PD 별도 히스토리 요청 없으면** 완료 아카이브 본문 언급 금지 (참조 링크만)
- **예외**: PD가 경위·맥락·이력 직접 요청 시 가능
---
## 연관 규칙
- **L1**: C13 PD 지시 트래킹 의무·C32 대화로그·C33 정보 동기화 (`bt-foundation`)
- **C20-7**: 코어룰 신설/변경·main 반영 시 완료 보고 (`bt-commit-rules`)
- **C40**: 세션 공유·종결 5종 점검 (`bt-session-mgmt`)