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

.agents/references/architecture.md

@@ -45,7 +45,7 @@ gravity_control/
 ├── bridge.py                # 파일 기반 IPC (레거시 fallback) (479줄)
 ├── watcher.py               # Brain 디렉토리 변경 감시 (290줄)
 ├── parser.py                # Markdown → Discord 변환 (245줄)
-├── collector.py             # 원격 파일→HTTP 릴레이 (Phase 2 삭제 예정) (517줄)
+├── collector.py             # 원격 파일→HTTP 릴레이 (⚠️ DEPRECATED — WS Hub 사용) (523줄)
 │
 ├── ── Extension 측 (TypeScript) ──
 ├── extension/src/
@@ -252,11 +252,16 @@ Extension(step-probe.ts) → 새 step 텍스트 감지
 ```
 AG Engine → 파일 수정 → Extension(step-probe.ts)
   → edit_step_indices + modified_files 메타데이터 수집
-  → writePendingApproval (step_type="diff_review")
+  → writePendingApproval (step_type="diff_review", 8초 지연)
   → Discord (Accept all / Reject all 버튼)
-  → 응답 → acknowledgeCodeActionStep RPC
+  → 응답 → handleDiffReviewResponse()
+     → openReviewChanges → 파일별 포커스 → agentAcceptAllInFile VS Code 커맨드
 ```
 
+> [!IMPORTANT]
+> diff_review는 **VS Code 커맨드만 유효**합니다. RPC 방식(AcknowledgeCascadeCodeEdit 등)은 모두 실패 확정.
+> 상세 경위는 known-issues-archive.md의 "Diff Review 관련" 섹션을 참조하세요.
+
 ---
 
 ## 5. 통신 프로토콜
@@ -292,7 +297,7 @@ AG Engine → 파일 수정 → Extension(step-probe.ts)
 |------|---------|-------------|------|
 | `local` | ✅ (brain 감시) | ❌ | 로컬 개발 (Extension과 같은 PC) |
 | `gateway` | ❌ | ✅ (port 8585) | 서버 배포 (WS Hub + Gateway) |
-| `remote` | ✅ | ❌ | 원격 브릿지 (레거시 Collector) |
+| `remote` | ✅ | ❌ | ⚠️ **DEPRECATED** — 레거시 Collector (WS Hub 사용 권장) |
 
 ---