BurningTimesAi/README.md

# 너드나비스 조직 레포 (NerdNavisAi)

너드나비스 게임 개발 스튜디오의 **Claude 에이전트 자산 + 조직 프로세스·노하우** 동기화 저장소.

## 구성

| 디렉토리 | 내용 |
|---------|------|
| `CLAUDE.md` | 조직 최상위 지침. PD·총괄PM·개발실장·기획팀장 구조 정의 |
| `공유/` | PD 지시 트래킹·일일보고·조직공지·부서간 REQ |
| `개발실/` | 개발실 자산 (에이전트 정의·코어 설계·프로젝트 숙지 문서) |
| `기획실/` | 기획실 자산 (에이전트 정의·밸런싱 .md·스킬 모듈) |
| `memory/org/` | Claude 사용자 메모리 (외부 `~/.claude/projects/*/memory/` 에서 복사·심볼링크 대상) |
| `setup/` | 다중 PC 셋업 스크립트 (Windows·macOS) |

## 첫 사용자 셋업

### 1. Clone

```bash
git clone https://burning.i234.me/NerdNavis/NerdNavisAi.git "C:/Users/PC/Documents/너드나비스"
```

또는 SSH:

```bash
git clone ssh://git@burning.i234.me:30030/NerdNavis/NerdNavisAi.git "C:/Users/PC/Documents/너드나비스"
```

### 2. `paths.local.json` 작성

`paths.local.json.template`을 복사하여 본인 PC 환경에 맞게 수정.

```bash
cp paths.local.json.template paths.local.json
```

이 파일은 `.gitignore`에 등록되어 있어 커밋되지 않습니다.

### 3. Claude 사용자 메모리 연결 (권장)

```powershell
# Windows
.\setup\setup_windows.ps1
```

```bash
# 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`·`기획실/.cache/`)
- DB 실물 (`*.sqlite`)
- 개발실 스켈레톤 (`개발실/코어_설계/_skeleton/`) — 별도 UPM 레포로 분리 예정

## 규칙

본 레포에서 일하는 모든 에이전트·작업자는 `.claude/skills/너드나비스-코어룰/SKILL.md`(단일 SOT)를 반드시 준수합니다. 부서 서브에이전트는 frontmatter `skills: [너드나비스-코어룰]` 로 자동 주입받고, 메인 세션은 CLAUDE.md `@.claude/skills/너드나비스-코어룰/SKILL.md` 로 로드합니다.

- **C1~Cn**: 핵심 규칙 (PD님만 수정)
- **P1~P20**: 프로젝트 규칙 (팀장급 재량)

## 라이선스·비공개

본 레포는 **Private**. 외부 공유·복제 금지.