깃 관리자
5cc02a831b
## 심층 원인 분석 결과 - Layer 1 (직접): Inbox 이동 시 PD 지시 로그 경로 컬럼 갱신을 별도 수동 수행 → 누락 쉬움 - Layer 2 (구조): 파일 이동(git mv)과 참조 갱신이 독립 트랜잭션 - Layer 3 (전수): 활성 운영 문서 4건에서 추가 부재 경로 발견 (개발팀 1건·기획팀 3건) ## 즉시 시정 (추가 4건 경로 정정) - 개발팀 #26: 2026-04-16_코어코드_git통합_점검 → 공유/소통/완료/ - 기획팀 #27: 2026-04-16_유니티프로젝트_점검_기획팀 → 공유/소통/완료/ - 기획팀 #26: 2026-04-16_하이브리드구조_기획팀의견 → 공유/소통/완료/하이브리드구조_기획실의견 (구 명칭 파일명 보존) - 기획팀 #25: 2026-04-16_프로세스고도화_개선안_기획팀 → 공유/소통/완료/프로세스고도화_개선안_기획실 - verify_log_paths: 18건 전수 실존 확인 (재검증 통과) ## 구조적 3중 방어 장치 신설·편입 1. **예방 — scripts/archive_inbox.sh 신설**: Inbox 파일 이동 + PD 지시 로그 경로 자동 정정 + verify 검증을 단일 트랜잭션으로 수행. 수동 git mv/sed 금지 2. **감지 1 — SessionStart hook에 verify_log_paths.sh 편입 (기존)**: PD 지시 로그 부재 경로 세션 시작 시 자동 경고 3. **감지 2 — scripts/verify_references.sh 신설 + SessionEnd hook 편입**: 활성 운영 영역(PD 지시 로그·Inbox·조직공지) 참조 무결성 감사. 역사 기록(완료/·대화로그·과거 조직공지)·placeholder·예정 산출물은 명시적 제외 ## 노하우 축적 - memory/feedback_inbox_archive_path_sync.md 확장: 3중 방어 구조·역사 보존 원칙 영구 기록 - "역사 기록 vs 활성 참조" 구분 원칙 확립: 대화로그·완료 아카이브는 작성 당시 경로 보존, 사후 정정하지 않음 ## 세션 전환 복원 보장 검증 - PD 지시 로그 활성 18건 전수 실존 ✅ - 활성 운영 참조 무결성 0건 ✅ - 원격 main = 로컬 HEAD ✅ - SessionStart·SessionEnd hook 8종 정상 등록 ✅ Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .claude | ||
| .live | ||
| memory | ||
| scripts | ||
| setup | ||
| 공유 | ||
| 코어코드/NerdNavis.Framework | ||
| 프로젝트 | ||
| .gitattributes | ||
| .gitignore | ||
| CLAUDE.md | ||
| README.md | ||
| paths.local.json.template | ||
README.md
너드나비스 조직 레포 (NerdNavisAi)
너드나비스 게임 개발 스튜디오의 Claude 에이전트 자산 + 조직 프로세스·노하우 동기화 저장소.
구성
| 디렉토리 | 내용 |
|---|---|
CLAUDE.md |
조직 최상위 지침. PD·총괄PM·개발팀장·기획팀장 구조 정의 |
공유/ |
PD 지시 트래킹·일일보고·조직공지·부서간 소통 허브 |
코어코드/ |
개발팀 코어 코드 프레임워크 자산 |
프로젝트/ |
프로젝트별 자산 (에이전트 정의·기획·개발 산출물) |
memory/org/ |
Claude 사용자 메모리 (외부 ~/.claude/projects/*/memory/ 에서 복사·심볼링크 대상) |
setup/ |
다중 PC 셋업 스크립트 (Windows·macOS) |
첫 사용자 셋업
1. Clone
git clone https://burning.i234.me/NerdNavis/NerdNavisAi.git "C:/Users/PC/Documents/너드나비스"
또는 SSH:
git clone ssh://git@burning.i234.me:30030/NerdNavis/NerdNavisAi.git "C:/Users/PC/Documents/너드나비스"
2. paths.local.json 작성
paths.local.json.template을 복사하여 본인 PC 환경에 맞게 수정.
cp paths.local.json.template paths.local.json
이 파일은 .gitignore에 등록되어 있어 커밋되지 않습니다.
3. Claude 사용자 메모리 연결 (권장)
# Windows
.\setup\setup_windows.ps1
# macOS / Linux
bash setup/setup_macos.sh
이 스크립트는 ~/.claude/projects/<해시>/memory/ 를 memory/org/ 로 junction/symlink 연결합니다.
제외 대상 (.gitignore 요약)
- Unity 프로젝트 산출물 (
Library/·Temp/·Build/) - 로컬 환경 파일 (
paths.local.json·settings.local.json·.env) - 시크릿 (
*.key·*.pem·secrets/·*.token) - 기획팀 대용량 (
*.xlsm·*.xlsx) - DB 실물 (
*.sqlite) - 코어코드 스켈레톤 (
코어코드/_skeleton/) — 별도 UPM 레포로 분리 예정
규칙
본 레포에서 일하는 모든 에이전트·작업자는 .claude/skills/너드나비스-코어룰/SKILL.md(단일 SOT)를 반드시 준수합니다. 부서 서브에이전트는 frontmatter skills: [너드나비스-코어룰] 로 자동 주입받고, 메인 세션은 CLAUDE.md @.claude/skills/너드나비스-코어룰/SKILL.md 로 로드합니다.
- C1~Cn: 핵심 규칙 (PD님만 수정)
- P1~P20: 프로젝트 규칙 (팀장급 재량)
라이선스·비공개
본 레포는 Private. 외부 공유·복제 금지.