NerdNavis_AiDev
/
BurningTimesAi
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
BurningTimesAi/공유/조직공지/2026-04-21_BT_조직_출범_인계서.md

8.9 KiB
Raw Blame History

2026-04-21 BurningTimes 조직 출범·전환 완결 인계서

목적: 2026-04-21 BurningTimes 신설 조직 전환 작업 전체 완결 상태를 다른 PC·다른 세션에서 인지·재현할 수 있도록 빠짐없이 공유하는 단일 인계서.

상태: 🟢 조직 전환 완결 (PD님 Discord 웹훅 실증 완료 · main push 전수 반영)

0. 조직 전환 요약

항목 내용
이전 조직 NerdNavis (레포: E:/NerdNavisAi, 원격: NerdNavis/NerdNavisAi.git) — 별도 병립 운영 유지
신 조직 BurningTimes (레포: E:/BurningTimes, 원격: NerdNavis_AiDev/BurningTimesAi.git)
첫 프로젝트 EerieVillage (기묘한 고을: 조선퇴마뎐) · Unity 6000.3.13f1 LTS · 2D PlatformerMicrogame 템플릿
코어 프레임워크 BT.Framework (구 NerdNavis.Framework Tier 1 16/16 계승)
조직 노하우 공유/조직자산/시행착오_아카이브/ 14종 (전 에이전트 동원 추출) + memory/org/ feedback 48종

1. 원격 저장소 상태 (최신 tag 체계)

태그 해시 의미
phase-2a-complete 5d5b1dd Skill/Framework rename + 조직명 치환
phase-2b-complete 44f7fb1 전 14개 에이전트 시행착오 아카이브
phase-2c-complete 616e3d3 삭제 + 추상화 + 재압축
잔존 정리 8ff5a1f asmdef rename + 코어 문서 추상화
세션 인계서 0bda9d3 Phase 2-C 후속 + 인계서 1차 발행
BT3 Unity MCP 셋업 aa61028 A안 + setup 자동 clone + Claude Desktop HTTP 초안
ToolSearch·Agent 자동 승인 6550dc7 권한 allow 추가
BT3 완결 + 조직 자산 5a161fc Unity MCP 연동 성공 실증 + 가이드 v2·조직공지·feedback·시행착오 아카이브

롤백 경로: 태그 기준 git reset --hard phase-2X-complete 또는 git show <tag>:<path> 역사 조회 가능.

현재 main HEAD: 5a161fc (본 인계서 갱신 기준)

2. 다른 PC에서 이어 작업하는 절차 (필수 5단계)

2-1. BT 레포 clone·pull

# 신규 PC — clone
git clone https://burning.i234.me/NerdNavis_AiDev/BurningTimesAi.git "E:/BurningTimes"

# 기존 PC — pull
cd E:/BurningTimes && git pull origin main

2-2. paths.local.json 생성 (PC별 실값 — gitignore 대상이라 각 PC에서 개별 작성)

cp paths.local.json.template paths.local.json

편집 필수 항목:

  • UNITY_PROJECT_ROOT: 해당 PC의 Unity 프로젝트 경로 (본 PC 예시: E:/NerdNavis/EerieVillage)
  • FRAMEWORK_PKG_ROOT: BT.Framework 패키지 로컬 경로 (분리 레포 결정 시)
  • DISCORD_WEBHOOK: BT 조직 공용 Discord 웹훅 URL (PD님 제공값, PC 공용)

2-3. setup 스크립트 실행 (burningtimes-* 중앙 저장소 junction 재연결)

# Windows
.\setup\setup_windows.ps1

# macOS / Linux
bash setup/setup_macos.sh

자동 수행 항목:

  • $HOME/.claude/burningtimes-live/ · burningtimes-memory/ · burningtimes-audit/ 3종 중앙 디렉토리 생성
  • E:/BurningTimes/.live/ → burningtimes-live/ junction
  • $HOME/.claude/.burningtimes_auditor_calls·warning_ignored·bypass_log audit junction 3종
  • Claude user memory junction → burningtimes-memory/
  • git config core.hooksPath scripts/git-hooks (post-commit hook 자동 활성)

2-4. 검증 스크립트

.\scripts\verify_setup.ps1

모든 항목 ✅ 확인 후 Claude Code 세션 시작.

2-5. Claude Code 세션 시작

  • 레포 루트(E:/BurningTimes)에서 단일 PM 세션 시작 (C24 단일 세션 운용 원칙)
  • SessionStart hook 체인 자동 실행:
    • git 최신 동기화 상태 확인
    • 매니페스트 상태 표시
    • 최근 feedback 요지 주입
    • inbox·PD 지시 로그 경로 감사
    • Live 세션 로드 (burningtimes-live 경유 C34 증분)

2-6. Unity MCP 환경 셋업 (BT3 2026-04-22 완결 · 필수 추가)

BT는 Unity MCP (CoplayDev MCP for Unity) 기반으로 Unity Editor 조작을 수행한다. 신규 PC에서 Unity MCP 사용 전 필수 설치:

  1. uv 설치: winget install --id=astral-sh.uv -e → 터미널 재시작
  2. uvx 수동 사전 워밍업 (필수 — pywin32 캐시 락 회피): 
    & "<uvx.exe 경로>" --from mcpforunityserver mcp-for-unity --help
    3~5분 소요. uvx 경로는 Get-Command uvx | Select-Object Source
  3. Unity Editor + MCP for Unity Package 설치:
    • Unity Hub → EerieVillage 프로젝트 열기
    • Package Manager → + → "Install package from git URL..." → https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
  4. MCP for Unity 창 설정 (Unity 상단 메뉴 → Window → MCP for Unity):
    • Transport: stdio (HTTP Local 아님)
    • "Start Server" 클릭
    • Client: Claude Desktop 선택
    • "Configure" 클릭 → claude_desktop_config.json 자동 생성
  5. Claude Desktop 완전 재시작 (트레이 아이콘 우클릭 → Quit → 재실행)
  6. 검증: Claude에게 "Unity Console 로그 읽어줘" 요청 → mcp__unityMCP__read_console 실수신 확인

상세 가이드: 공유/개발팀_자산/Unity_MCP_연동_가이드_v1.md (v2 개정본) 조직공지 표준: 공유/조직공지/2026-04-22_Unity_MCP_연동_표준_워크플로우_v2.md 트러블슈팅: memory/org/feedback_mcp_setup_pitfalls.md (함정 5종 재발 방지 SOT) 시행착오 근거: 공유/조직자산/시행착오_아카이브/개발_MCP연동_v1.md (7단계 타임라인)

3. Discord 웹훅 (PC 독립 · Gitea 서버측)

  • 등록 위치: Gitea UI https://burning.i234.me/NerdNavis_AiDev/BurningTimesAi/settings/hooks
  • 이벤트: Push
  • 실증: 2026-04-21 8ff5a1f push로 알림 수신 확인 (PD님 직접 검증)
  • PC 독립성: 서버측 설정이라 어느 PC에서 push해도 동일 Discord 채널로 알림

4. 보류 안건 (Phase 3 — EerieVillage 착수 시점)

PD님 결정 6번에 따라 별도 세션·별도 Phase로 진입:

  1. 서버 아키텍처·보안 체계 선택 (이전 Critical 3건 해소 방안)
  2. BT.Framework Tier 2·3 진입 경계
  3. Unity MCP 편집 표준 워크플로우 v2
  4. 조선·퇴마 세계관 SOT·glossary·톤앤매너 기준선
  5. 2D 플랫포머 모바일 UX 초기 설계
  6. Prove-2-of-3·덱빌딩 메카닉 이식 가능성 검토
  7. 어뷰징 판정 경계값 재평가

5. 조직 자산 참조 경로

필독 자산 (세션 시작 시 자동 로드)

  • CLAUDE.md — 조직 최상위 지침
  • .claude/skills/BurningTimes-코어룰/SKILL.md — 헌법 제1원칙·C1~C37·P1~P31 단일 SOT
  • memory/org/MEMORY.md — feedback 인덱스

시행착오 아카이브 (이전 프로젝트 교훈, 14종)

공유/조직자산/시행착오_아카이브/

  • 총괄_pm_general_v1.md · 개발_팀장·서버팀장·클라이언트팀장_v1.md · 기획_팀장·system·content·level·narrative·balance·ux_designer_v1.md · 감사_pm·dev·plan_auditor_v1.md

폐기·방향전환 아카이브

  • 공유/조직공지/폐기_규칙_아카이브.md — C·P 폐기 이력 (P17 2026-04-21 폐기 포함)
  • 공유/조직공지/방향전환_히스토리_아카이브.md — 설계 방향 전환 이력

6. PD님 지시 로그 상태

로그 활성 완료 아카이브
개발팀 없음 (BT1·BT2·BT3 전수 완료 이동) BT1·BT2·BT3
기획팀 없음 (BT1·BT2 전수 완료 이동) BT1·BT2

Phase 3 EerieVillage 착수 지시 수령 시 신규 항목 등록 예정.

7. 세션 인계 체크리스트 (다른 PC PM 세션 시작 시)

  • git pull origin main 실행 → 5a161fc 이상 HEAD 확인
  • paths.local.json 생성 (template 복사 + 실값 입력 · UNITY_PROJECT_ROOT·DISCORD_WEBHOOK 필수)
  • setup 스크립트 실행 (setup_windows.ps1 또는 setup_macos.sh) → unity-mcp 자동 clone 포함
  • verify_setup.ps1 통과
  • Unity MCP 셋업 (§2-6) — uv 설치·수동 워밍업·Unity Package·Configure·Claude Desktop 재시작
  • 본 인계서 Read → 조직 현 상태 인지
  • CLAUDE.md + .claude/skills/BurningTimes-코어룰/SKILL.md + MEMORY.md 로드 확인
  • 공유/조직자산/시행착오_아카이브/ 관련 영역 Read (BT 착수 시점 필수)
  • 공유/조직공지/2026-04-22_Unity_MCP_연동_표준_워크플로우_v2.md Read (MCP 표준 7규범)
  • memory/org/feedback_mcp_setup_pitfalls.md Read (재발 방지 함정 5종)
  • PD 지시 로그 활성 항목 확인 (현재 0건)
  • Phase 3 착수 시 PD님 지시 수령 후 신규 PD 지시 로그 항목 등록

인계서 상태

  • 최종 수정: 2026-04-21
  • 생성 근거: PD님 2026-04-21 "다른 PC에서 이어할 수 있도록 빠짐없이 공유" 지시
  • 영구 보존: 본 인계서는 조직 역사 기록 성격. 차기 조직 전환·분리 시 참고 템플릿