diff --git a/CLAUDE.md b/CLAUDE.md
index 7abdd95..ca88505 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -72,14 +72,27 @@ docker-compose up -d
 - `src/lib/api.ts` — Backend API client
 - Uses lightweight-charts for financial charts, recharts for other visualizations
 
+### galaxis-agent (`~/workspace/quant/galaxis-agent/`)
+
+galaxis-po를 자율적으로 개발하는 SWE 에이전트 (별도 Gitea 리포: `quant/galaxis-agent`).
+
+- `agent/` — 핵심 모듈: dispatcher, task_queue, cost_guard, task_history, recovery, auto_merge
+- `agent/integrations/` — Discord bot, sandbox backends
+- `agent/tools/` — 에이전트 도구 (gitea_comment, discord_reply)
+- `agent/utils/` — 유틸리티 (gitea_client, discord_client, git_utils)
+- `tests/` — 테스트 (139개, Phase 1-4)
+- 설계 스펙: `docs/superpowers/specs/`, 구현 플랜: `docs/superpowers/plans/`
+
 ## Development Rules
 
-1. Check `docs/plans/` for relevant design documents before implementing features
+1. Check `docs/plans/` and `docs/superpowers/plans/` for relevant design documents before implementing features
 2. All API endpoints go under `backend/app/api/` as routers
-3. DB schema changes require an alembic migration
-4. Do not modify `.env` or `docker-compose.prod.yml`
+3. DB schema changes require an alembic migration — autogenerate 후 반드시 리뷰하고 즉시 `alembic upgrade head`
+4. Do not modify `.env` or `docker-compose.prod.yml` (`.env` 설정 안내는 허용, 자동 수정은 금지)
 5. Python: snake_case; TypeScript: camelCase
-6. External APIs: KIS (Korea Investment & Securities) for market data, DART for financial statements, pykrx for Korean exchange data
+6. External APIs: pykrx (한국 거래소 데이터, 백테스트/시그널 주력), KIS (실시간 매매), DART (재무제표)
+7. 커밋은 논리 단위별로 개별 생성. 커밋 전 관련 테스트 실행 필수
+8. Frontend 변경 후 `cd frontend && npx tsc --noEmit` 필수
 
 ## Environment