docs: known-issues 아카이빙 + Collector 폐기 마킹 + 레퍼런스 문서 보강 #task-409

.agents/references/tech-stack.md

@@ -32,6 +32,7 @@
 | @types/vscode | VS Code Extension API 타입 |
 | @types/node | Node.js 타입 |
 | typescript | 컴파일러 |
+| ws | WebSocket Hub 연결 (`.vscodeignore`에 `!node_modules/ws/**` 필수) |
 | antigravity-sdk | AG RPC 호출 (로컬 임베드 `sdk/`) |
 
 ## 패키지 관리
@@ -67,7 +68,10 @@
 | 변수명 | 용도 | 기본값 |
 |--------|------|--------|
 | BRAIN_PATH | AG 브레인 경로 | `~/.gemini/antigravity/brain` |
-| BOT_MODE | `local` / `remote` / `gateway` | `local` |
+| BOT_MODE | `local` / ~~`remote`~~ / `gateway` | `local` |
+
+> [!WARNING]
+> `BOT_MODE=remote` (Collector 모드)는 **deprecated**입니다. `gateway` 모드 + Extension WS를 사용하세요.
 | DEBOUNCE_SECONDS | Watcher 디바운스 간격 | `5` |
 | PROJECT_NAME | 프로젝트 이름 | `gravity_control` |
 
@@ -79,7 +83,7 @@
 | GATEWAY_API_KEY | REST API 인증 키 | (미설정 시 인증 미사용) |
 | GRAVITY_HUB_SECRET | WS Hub JWT 서명 시크릿 (64char hex) | (미설정 시 인증 생략) |
 | GRAVITY_REGISTRATION_CODE | Extension 등록 코드 (32char hex) | (미설정 시 인증 생략) |
-| REMOTE_BRIDGE_URL | Collector 원격 URL | (remote 모드 전용) |
+| REMOTE_BRIDGE_URL | ~~Collector 원격 URL~~ | ⚠️ deprecated (remote 모드 전용) |
 
 ## Extension VS Code 설정