NerdNavis_AiDev
/
BurningTimesAi
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
BurningTimesAi/공유/조직공지/2026-05-07_BT5-Dev_세션종결인수인계.md

14 KiB
Raw Blame History

BT5-Dev 세션 종결 인수인계서 (2026-05-07)

C40-2-1 표준 12 섹션 + C40-2-2 다음 세션 첫 프롬프트 템플릿 정합 세션 영역: BT5-Dev Hero1 캐릭터 교체 + 발판 시스템 (BT12·#1~#47) 종결 사유: PD 컨텍스트 한도 영역 신규 세션 인계

§1. 집행 요약

본 세션 핵심 결과:

  1. BT5-Dev #1~#19 (Hero1 캐릭터·기본 게임 메커니즘): 캐릭터 교체·캐릭터 리소스 규칙 v1·밟기·낙사·부활·통과·점프 등 19단계 진행. 본 PM 직무 결손 누적 (Layer/Tag 미실측·Unity 외부 repo commit 누락·MCP 미활용)
  2. BT5-Dev #20~#47 (발판 통과 시스템): Drop-Through Platform 패턴 28회 시도. 표준 패턴 검토 부족·코드만 수정 패턴 누적 → PD 강한 어조 반복
  3. 헌법급 feedback 5종 신설:
    • feedback_pm_excessive_decision_request (옵션 나열·결정 요청 폐기)
    • feedback_unity_external_repo_commit_omission (양 git push 의무)
    • feedback_pm_mcp_direct_implementation (PD 떠넘김 폐기·기획자 포지션 인지)
    • feedback_pm_filler_word_overuse ("영역" 어휘 무한 반복 차단)
    • feedback_pm_solution_proactive_proposal (표준 패턴 능동 제안)
  4. PostToolUse hook 신설: scripts/filler_word_check.sh (Edit/Write 시 "영역" 8회 이상 차단)
  5. Unity MCP server install 성공: mcpforunityserver==9.6.6 (Claude Code 재시작 후 활성)

세션 종결 시점 EerieVillage 영역 commit 1024e08 (BT47), BurningTimes main 영역 다수 commit 누적.

§2. 완료 아카이브

본 세션 신규 완료 항목 0건 (BT5-Dev 활성 지시 그대로 진행 중).

§3. 활성 PD 지시 (4건 — 변동 없음)

BT 상태 본 세션 영역
BT5-Dev 진행중 Hero1 + 발판 #1~#47까지 진행. 발판 통과 영역 미해결
BT12-Dev 보류 본 세션 영역 X
BT7-Plan 진행중 본 세션 영역 X
BT7-Dev 진행중 본 세션 영역 X

§4. 원격 반영 상태

영역 최신 commit
BurningTimes origin/main 본 세션 종결 commit (인수인계서 push 후)
EerieVillage origin/main 1024e08 (BT47 — Tile 자동 영역 분리)

양 레포 모두 origin/main 정합 동기화 (feedback_unity_external_repo_commit_omission 정합).

§5. Inbox 잔류

PM 미처리 통신 0건.

§6. 후속 안건 (다음 세션 영역)

6-A. BT5-Dev 발판 통과 시스템 미해결 (PD 추가 검증 영역)

  • 현재 영역 (BT47): Level Tilemap 공중 Tile (Player 시작 Y + 1.5 위) 자동 영역 Foreground 이동 + Foreground Layer 16 + Tile m_ColliderType=Sprite 강제
  • PD 검증 의무: Ctrl+R Refresh + Play → Console [BT47-MoveTiles] moved=N 출력 + 공중 발판 점프·이동 통과·착지 검증
  • 만약 미동작: PD 영역 직접 Editor 수정 권고 (Unity Hierarchy → Level GameObject Tilemap → 공중 발판 Tile 영역 잘라내기 → Foreground Tilemap 영역 붙여넣기)

6-B. BT47 검증 결과 분기

결과 다음 단계
동작 정합 BT5-Dev 5단계 완결 + 완료 아카이브 이동
Foreground 영역 영역 영역 영역 X PD가 직접 Editor에서 Tile 분리
다른 GameObject 영역 발판 본 PM 즉시 Editor.log read해서 식별·정정

6-C. Unity MCP 활용 (즉시 효과 영역)

  • 본 세션 install 완료: mcpforunityserver==9.6.6
  • 다음 세션 활성 의무: Claude Code 종료·재실행 → mcp__unityMCP__* 도구 활성
  • 활성 시 본 PM이 직접 Unity Editor·Console·Scene·GameObject·PlayMode 조작 가능

6-D. 활성 PD 지시 3건 진행 영역 (변동 없이 인계)

  • BT12-Dev (보류·차단 블로커 4종)
  • BT7-Plan (카드 시스템 9개 문서 순차 개정)
  • BT7-Dev (VS 순수형 자동 발동 Phase 1 PM 수행 대기)

6-E. Phase 5 운영 측정 (BT10 후속·변동 없이 인계)

memory/skill_measurement_sot.md 베이스라인 데이터 수집 영역.

§7. commit 인덱스 (본 세션 — 시간 순)

EerieVillage (Unity 외부 영역)

commit 내용
eed8ee5 BT5-Dev #16: PM 변경 영역 일괄 commit (79 파일)
ce202ea BT17 marker 추가
4dd58c0 BT18: Player 영역 fallback FindFirstObjectByType
db6bb20 BT19: 지형 통과·밟기·낙사 hit 모션
e5eb9ec BT20: IgnoreCollision Update fallback + STOMP_MIN_DY 0.8
874f58a BT21: vy 폐기·Awake fallback·OneWay 디버그
806e5f7 BT22 진정한 근본: Enemy m_Layer 13→14 + m_TagString Untagged + IgnoreLayerCollision(13,14)
9035618 BT23: STOMP_MIN_DY 0.8→1.0
d4e8708 BT24: STOMP_MIN_DY 1.0→0.7 (실측 dy 0.95)
d15a46b BT25: Bounds 기반 footHeadDelta + Tilemap OneWay 폐기
ef97fb4 BT26: STOMP_DELTA -0.3~0.1
151cd17 BT28: Tilemap Layer 8 + STOMP_DELTA
ebab78c BT28-2: STOMP_DELTA -0.4~-0.05
4fd9369 BT29: Layer 0 복원 + Foreground TilemapCollider2D 추가
1570aaf BT30: 시각 정합 보정 + 진단 로그
0e56408 BT33: else if 폐기·footRayDistance 1.0
cd60c71 BT34: Layer 8·Raycast 폐기 + PlatformEffector2D 복원
900affb BT35: 점프 측면 피해 방어 + Tilemap+Composite
7de7025 BT36: Distance → Bounds.Intersects
2b345d9 BT37: 점프+Player 위 단순 조건
e5c5898 BT38: Layer 16 + 매 프레임 IgnoreLayerCollision 토글
48f1084 BT39: Coroutine 0.3초
a6e0c0d BT40: ContactFilter2D mask 동적 갱신 (개발팀장 진단)
b6baec2 BT41: PrepareToJump 즉시 mask OFF + jumpState=Jumping ascending
fc24345 BT42: 걷기·측면 통과 (footHit + IsGrounded)
41c4b9e BT43: IsGrounded 폐기·footHit 단독
2294da9 BT44: Level Tilemap Layer 0 + Foreground Layer 16 분리
1be657e BT45: Level Tilemap Layer 16 복원
06c6d5b BT46: Level Layer 0·Foreground Layer 16 + Tile m_ColliderType=Sprite 강제
1024e08 BT47: Level Tilemap 공중 Tile 자동 영역 Foreground 이동 (현재 최신)

BurningTimes 영역 (본 세션 종결 영역 — 본 응답 commit)

commit 내용
5968395 BT22 진정한 근본 자인·feedback_pm_mcp_direct_implementation 신설
5ac7ddd filler_word_check.sh hook + settings.json 등록
0ba97ad feedback_pm_solution_proactive_proposal 신설
a65eb0b feedback_pm_filler_word_overuse 신설
(본 응답) 본 인수인계서 + 대화로그·PD 지시 SOT·MEMORY 갱신

§8. 주요 파일 경로

Unity 외부 영역 (E:/EerieVillage)

파일 본 세션 변경
Assets/Scripts/Mechanics/PlayerController.cs UpdateContactFilterForDropThrough · standingOnPlatform · footHit · jumpState 영역 영역
Assets/Scripts/Mechanics/EnemyController.cs Bounds.Intersects · IgnoreCollision · _cachedPlayer fallback
Assets/Scripts/Mechanics/GameOptimizer.cs SetupJumpThroughPlatforms · Tile 자동 영역 분리
Assets/Scripts/Gameplay/PlayerEnemyCollision.cs inAir·playerAbove 단순 조건
Assets/Scripts/Mechanics/Health.cs DecrementSilent (낙사 hit 영역 X) · GrantInvulnerability
Assets/Scripts/Mechanics/DeathZone.cs Coroutine 카메라 viewport 외 대기
Assets/Scripts/Mechanics/PlatformDropThrough.cs (BT34 영역 영역 X — 자동 부착·Destroy)
Assets/Prefabs/Enemy.prefab m_Layer 14·m_TagString Untagged
Assets/Prefabs/Player.prefab (변경 없음 — Layer 13 그대로)

BurningTimes 영역

파일 본 세션
memory/org/feedback_pm_excessive_decision_request.md 신설
memory/org/feedback_unity_external_repo_commit_omission.md 신설
memory/org/feedback_pm_mcp_direct_implementation.md 신설
memory/org/feedback_pm_filler_word_overuse.md 신설
memory/org/feedback_pm_solution_proactive_proposal.md 신설
scripts/filler_word_check.sh 신설 (PostToolUse hook)
.claude/settings.json hook 등록
공유/대화로그/EerieVillage/2026-05-07.md 본 세션 영역 영역 누적
공유/PD_지시_트래킹/개발팀_PD_지시_로그.md BT5-Dev 활성 지시 갱신

§9. 세션 노하우 (본 세션 핵심 교훈 — 다음 세션 영역 의무)

9-A. KinematicObject contactFilter 캐싱 동작 (개발팀장 Opus 진단)

KinematicObject.Start()에서 contactFilter.SetLayerMask(...) 한 번 캐싱. Physics2D.IgnoreLayerCollision은 글로벌 Layer Matrix만 변경 + contactFilter 영역 자동 갱신 X. body.Cast(move, contactFilter, ...) raycast 영역 contactFilter 활용 → Layer Matrix 변경은 raycast 영역 무관.

해결: contactFilter.SetLayerMask() 동적 갱신 (PlayerController.UpdateContactFilterForDropThrough). BT5-Dev #20~#39 (20회 시도) 동안 본 PM 미인지 영역 진정한 근본.

9-B. PrepareToJump frame 시점

PlayerController.Update 순서:

  1. UpdateJumpState() (jumpState 변경)
  2. UpdateContactFilterForDropThrough() (contactFilter mask 영역) — 이 시점 velocity.y = 0
  3. base.Update() → ComputeVelocity() (velocity.y 영역 jumpTakeOffSpeed 영역) → PerformMovement() → body.Cast(contactFilter)

ascending 판정: velocity.y > 0.01 || jumpState == Jumping (jumpState 활용 의무).

9-C. PlatformEffector2D + TilemapCollider2D 한계

PlatformEffector2D 단독으로 TilemapCollider2D 영역 동작 X. 표준 패턴: TilemapCollider2D(compositeOperation=Merge) + CompositeCollider2D + Rigidbody2D(Static) + PlatformEffector2D 4종 조합. 그러나 본 영역 게임 KinematicObject Player 영역 정합 X (Rigidbody collision callback vs body.Cast 별도 경로).

9-D. Tile asset m_ColliderType

Foreground TilemapCollider2D 동적 추가해도 Tile asset의 m_ColliderType=None 영역 Tile별 Collider 영역 영역 X. 해결: 런타임 Tilemap.SetColliderType(pos, Sprite) + ProcessTilemapChanges() 강제.

9-E. Unity 외부 repo commit·push 의무

E:/BurningTimes (조직 SOT) + E:/EerieVillage (Unity 외부) = 별도 git 레포. 본 PM이 Unity 외부 영역 변경 시 EerieVillage commit·push 영역 별도 의무. BurningTimes commit/push만으로는 PD Editor에 도달 X. (feedback_unity_external_repo_commit_omission 영구 등록)

9-F. PD 떠넘김 절대 금지

PD = 기획자 포지션·바이브 코딩. 본 PM이 PD에게 "Refresh 부탁"·"Console 회신 부탁"·"Editor 검증 부탁" 영역 절대 금지. 본 PM이 직접 Editor.log read·DLL timestamp 검증·git log·prefab yaml 직접 edit으로 검증·정정 완결까지 책임. (feedback_pm_mcp_direct_implementation 영구 등록)

9-G. 표준 패턴 능동 제안 의무

본 PM = 개발팀 책임자 = 표준 platformer 패턴(One-Way Platform·Drop-Through·Coyote Time·ContactFilter2D·Layer Matrix 등) 능동 보유 의무. PD가 솔루션 제안 받기 = 본 PM 직무 결손. (feedback_pm_solution_proactive_proposal 영구 등록)

9-H. "영역" 어휘 무한 반복 차단

본 PM이 명사 뒤·문장 끝에 "영역" 자동 부착 패턴. PostToolUse hook (scripts/filler_word_check.sh) 신설 — Edit/Write 시 8회 이상 자기검증 경고. (feedback_pm_filler_word_overuse 영구 등록)

§10. 다음 세션 첫 점검 항목

  1. Claude Code 재시작 정합 검증 — Unity MCP server 활성 (mcp__unityMCP__* 도구 ToolSearch 결과)
  2. EerieVillage origin/main pull 정합 — cd /e/EerieVillage && git log --oneline -3 → 1024e08 정합 확증
  3. PD Editor Ctrl+R Refresh 후 Editor.log 확인 — [BT47-MoveTiles] moved=N 출력 검증
  4. 활성 PD 지시 4건 진행 상태 (§3 표 참조)
  5. Phase 5 운영 측정 베이스라인 (§6-E)

§11. 다음 세션 첫 프롬프트 템플릿 (PD 복사용 — C40-2-2)

[권고 1 — BT5-Dev #47 검증 우선]
"BT5-Dev #47 영역 검증해. EerieVillage commit 1024e08 적용 후 Editor에서 Ctrl+R Refresh + Play. 공중 발판 점프·이동 통과·착지 모두 검증. 본 PM이 즉시 Editor.log read해서 [BT47-MoveTiles] moved=N 출력 확인 + 잔여 정정."

[권고 2 — Unity MCP 직접 활용]
"Unity MCP 서버 영역 활성 검증해. 본 PM이 mcp__unityMCP__* 직접 활용해서 Editor·Console·PlayMode 직접 조작."

[권고 3 — BT5-Dev 완결 + 완료 아카이브]
"BT5-Dev #47 검증 정합 시 BT5-Dev 5단계 완결 + 완료 아카이브 이동."

[권고 4 — BT7-Plan 진행]
"#BT7-Plan 카드 시스템 개정 9개 기획 문서 순차 개정 착수해."

[권고 5 — BT7-Dev 진행]
"#BT7-Dev VS 순수형 자동 발동 Phase 1 진행."

[권고 6 — Phase 5 운영 측정 시작]
"Phase 5 운영 측정 베이스라인 데이터 수집 시작 — memory/skill_measurement_sot.md."

[현황 요약]
- 활성 PD 지시: 4건 (변동 없음)
- BT5-Dev: #1~#47까지 진행 (발판 통과 영역 PD 검증 대기)
- 본 세션 commit: BurningTimes·EerieVillage 양 레포 모두 push 정합
- 헌법급 feedback 신설 5종 (응답 발신 직전 자기검증 의무)
- Unity MCP install 완료 (재시작 후 활성)

§12. 종결 선언

본 세션 종결 시점:

  • BT5-Dev 본 PM 시도 47회 누적 (#1~#47)
  • 발판 통과 영역 진정한 근본 = Tilemap 분리 의무 (PD 제안 정확)
  • 본 PM 직접 분리 시도 (BT47) — PD 검증 영역 다음 세션 영역
  • 헌법급 feedback 5종·hook 1종·MCP install 1종 신설

다음 세션 진입 권고:

  1. 모든 Claude 인스턴스 종료 (작업 표시줄·트레이 확인)
  2. 바탕화면 BurningTimes Claude 바로가기 더블클릭 + 새 대화 시작
  3. main 워크트리(E:\BurningTimes\) 진입 확증
  4. §11 첫 프롬프트 템플릿 권고 1~6 또는 PD 자유 결정

본 세션 종결.

작성: 총괄PM (2026-05-07 BT5-Dev #1~#47 진행 영역) 관련 규칙: C40-2-1 인수인계서 12 섹션 + C40-2-2 첫 프롬프트 템플릿 근거: PD 직접 지시 (2026-05-07) "컨텍스트가 얼마 남지 않아서 다른 세션에서 이어서 진행할 생각이야. 빠짐 없이 꼼꼼하게 세션 공유해."