refactor: sync .agents/ with agent_guide template (helpers/ subdir, devlog, pre-task, debug, references)

.agents/references/tech-stack.md

@@ -0,0 +1,42 @@
+# Tech Stack — Gravity Web
+
+> AI 에이전트는 구현 전 이 문서를 확인하여 올바른 기술/버전을 사용합니다.
+
+## 언어 & 런타임
+
+| 항목 | 버전 | 비고 |
+|------|------|------|
+| Node.js | 시스템 설치 (`node`, `npm`) | 서버 + 빌드 |
+| Python | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe` | 헬퍼 스크립트 전용 |
+
+## 프레임워크 & 라이브러리
+
+| 항목 | 용도 |
+|------|------|
+| Express | HTTP 서버 |
+| ws | WebSocket 서버 |
+| chrome-remote-interface | CDP 클라이언트 |
+
+## 프론트엔드
+
+| 항목 | 설명 |
+|------|------|
+| 방식 | Vanilla HTML/CSS/JS (SPA) — 프레임워크 없음 |
+| 테마 | 다크 테마 |
+| 통신 | REST API + WebSocket (실시간) |
+
+## 개발 도구
+
+| 도구 | 명령어 |
+|------|--------|
+| 의존성 설치 | `cmd /c npm install` (server 디렉토리에서) |
+| 서버 실행 | `cmd /c node index.js` (server 디렉토리에서, port 3300) |
+| Antigravity 실행 | `"%LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe" --remote-debugging-port=9000` |
+
+## Shell 주의사항
+
+| 항목 | 규칙 |
+|------|------|
+| `curl` | PowerShell에서 `Invoke-WebRequest` 별칭 → **반드시 `curl.exe`** |
+| `npm` | 실행 정책 문제 시 **`cmd /c npm`** 사용 |
+| JSON 처리 | `.py` 스크립트로 만들어 실행 (PowerShell 이스케이핑 문제 방지) |