# 컴퓨터 이사 체크리스트 (Astra 지식 환경)

> 작성: 2026-07-11 · Astra v2.2.304 이식성 정리와 함께 생성
> 원칙: **지식(Wiki)과 프로그램(Astra)은 분리** — Wiki 는 git 으로 옮기고, Astra 는 vsix 로 설치하고, 설정에서 바꿀 절대 경로는 **두뇌 위치 1개**뿐이다.

## 새 컴퓨터에서 할 일 (순서대로)

1. **Wiki 저장소 클론** — 원하는 아무 위치에나:
   `git clone <Wiki 원격 주소>` (예: `D:\Wiki` 또는 `~/Wiki`)
2. **Astra 설치** — `astra-x.x.x.vsix` 파일을 VS Code 확장 메뉴 → "Install from VSIX".
3. **VS Code 설정에서 두뇌 경로 1개 변경**:
   - `g1nation.brainProfiles` 의 `localBrainPath` → `<새 Wiki 위치>/10_Wiki/Topics`
   - 이것으로 끝 — 아래 설정들은 두뇌 기준 **상대 경로**라 자동으로 따라온다:
     - `domainKnowledge.codingFolder` = `Domain_Programming`
     - `domainKnowledge.factsFolder` = `Domain_General`
     - `domainKnowledge.generalFolder` = `_Common`
     - `domainKnowledge.mathFolder` = `_Common/Math`
     - `datacollectSavePath` = `../../Premium/Thinking & Reasoning`
4. **NAS 브리지 토큰** — `g1nation.datacollectBridgeNasToken` 에 NAS `.env` 의 `BRIDGE_AUTH_TOKEN` 값 입력 (File Station → docker → Astra → .env 에서 복사).
5. **(선택) Datacollector 로컬 프로젝트** — research(NotebookLM) 기능을 쓰려면 Datacollector 프로젝트를 클론하고, 사이드바 "NotebookLM 백엔드 실행" 버튼을 누르면 폴더 선택 대화상자가 자동으로 안내한다 (경로 설정 수동 입력 불필요).
6. **(선택) Claude Code** — `/claude` 명령을 쓰려면 터미널에서 `npm install -g @anthropic-ai/claude-code` 후 `claude` 실행해 구독 계정으로 로그인.

## 왜 이렇게 되어 있나

- **Wiki 를 ConnectAI(소스코드) 폴더에 합치지 않은 이유**: Astra 는 다른 컴퓨터에서 vsix 로 설치되므로 소스 폴더 자체가 필요 없다. 합치면 이식성은 안 좋아지고 두 git 저장소만 꼬인다.
- **에이전트 지식 매핑**(`.astra/agent-knowledge-map.json`)은 워크스페이스 폴더와 함께 이동하며, 내용이 두뇌 상대 경로라 그대로 동작한다.
- 두뇌 경로가 잘못되면 Astra 준비 상태 바에 "두뇌 폴더가 없습니다" 경고가 뜬다 — 3번을 다시 확인할 것.