맥락:
- 몰입 모드 ON에서 상단 우측 액션이 허브 이동으로 보이는 혼선을 줄이고 즉시 이탈 동선을 제공하기 위해
변경사항:
- 몰입 모드 훅에 exitImmersionMode 액션 추가
- 몰입 모드 ON 시 상단 우측 액션을 나가기 버튼으로 전환
- 나가기 클릭 시 토스트(나가기(더미)) 노출 후 몰입 모드 OFF 처리
- docs/90_current_state.md, docs/session_brief.md 최신 상태 반영
검증:
- npx tsc --noEmit
세션-상태: 몰입 모드 ON에서 상단 우측 액션은 나가기로 동작함
세션-다음: RoomSheet/도크의 인원수 중심 정보를 분위기형 정보로 교체
세션-리스크: 터치 환경에서 미니 레일 발견성이 낮을 수 있어 UX 보완이 필요
맥락:
- /space 하단 사운드 바를 제거하고 도구를 우측 도크에 수납해 배경 몰입을 강화하며, 몰입 모드 ON 체감을 높이기 위해
변경사항:
- 하단 사운드 프리셋 바를 제거하고 도크에 🎧 Sound 패널을 추가
- features/sound-preset + widgets/sound-sheet를 추가해 프리셋 선택/믹서 UI(더미) 구성
- features/immersion-mode + shared/ui/Toggle을 추가하고 Quick 시트 토글과 연결
- 몰입 모드 ON 시 상단 Current Room 숨김, 허브 버튼 소형화, 레일 미니화, HUD 저대비, 비네팅/그레인 강화
- widgets/space-chrome를 신설해 /space 상단 크롬 렌더링을 분리
- docs/90_current_state.md, docs/session_brief.md 최신 상태로 갱신
검증:
- npx tsc --noEmit
세션-상태: /space는 사운드 시트 기반 도크 구조와 몰입 모드 UI를 제공함
세션-다음: RoomSheetWidget 인원수 기반 정보를 큐레이션 표현으로 전환
세션-리스크: 터치 환경에서 미니 레일 발견성이 낮을 수 있어 보조 힌트가 필요할 수 있음
맥락:
- workFlow 실행 시 기본 로드 문서 수를 줄여 토큰 사용량을 추가로 절감하기 위해
변경사항:
- docs/session_brief.md 신설(세션 시작용 초소형 스냅샷)
- docs/workFlow.md 기본 로드를 work + session_brief 2파일로 변경
- docs/README.md 우선 읽기 순서와 운영 원칙 갱신
- docs/90_current_state.md에 정책 변경 기록
검증:
- 문서 내용 수동 검토
- 기본 로드 입력 크기: work(497) + session_brief(718) = 1215 chars
세션-상태: workflow 기본 로드는 2파일 모드로 동작함
세션-다음: session_brief를 작업 종료 시 최신 상태로 유지
세션-리스크: session_brief 갱신이 누락되면 복구 정확도가 떨어질 수 있음
맥락:
- workFlow 실행 시 매번 여러 문서를 전부 읽어 토큰이 과도하게 소모되는 문제를 줄이기 위해
변경사항:
- docs/context_core.md 신설(핵심 규칙 요약본)
- docs/workFlow.md를 기본 3문서 + 조건부 로드 방식으로 변경
- docs/README.md에 context_core 및 토큰 절약 로드 원칙 반영
- docs/90_current_state.md에 이번 정책 변경 기록
검증:
- 문서 문자 수 기준 로드량 비교 계산
- old_always_chars=6226, new_always_chars=3015
세션-상태: workflow가 토큰 절약형 컨텍스트 로드를 사용함
세션-다음: 조건부 로드 문서 기준을 실제 작업 로그로 튜닝
세션-리스크: work.md 입력이 장문이면 절감 효과가 상대적으로 줄어들 수 있음
맥락:
- 작업 지시를 문서 기반으로 표준화하고, 실행 시 규칙 준수와 주제별 커밋을 강제하기 위해
변경사항:
- docs/work.md에 작업 입력 템플릿 추가
- docs/workFlow.md에 실행 순서, 규칙 준수, 커밋 절차 명시
- docs/README.md에 work/workFlow 문서 링크 추가
검증:
- 문서 내용 수동 검토
세션-상태: 문서 기반 작업 지시/실행 체계가 준비됨
세션-다음: 이후 작업부터 work.md 작성 후 workFlow.md 실행
세션-리스크: work.md가 비어 있으면 실행 전에 추가 확인이 필요
맥락:
- 커밋 메시지는 한국어로 작성해야 한다는 팀 규칙을 문서와 템플릿에 반영하기 위해
변경사항:
- docs/06_commit_convention.md에 한국어 작성 필수 규칙 추가
- docs/07_session_recovery.md의 커밋 예시를 한국어로 교체
- .gitmessage-session.txt 템플릿 본문 항목을 한국어로 변경
검증:
- 변경 파일 수동 검토
세션-상태: 한국어 커밋 규칙과 템플릿이 반영됨
세션-다음: 기능 커밋에도 동일한 한국어 템플릿을 적용
세션-리스크: 기존 과거 커밋 메시지는 영어가 포함될 수 있음
Context:
- codex cli 중단 후에도 작업 품질과 맥락을 안정적으로 복구하기 위해
Changes:
- docs/00~07, 90 문서 세트 추가/정리
- commit convention 문서 및 .gitmessage-session.txt 템플릿 추가
- scripts/session/recover-context.sh 추가
- package.json에 session:recover 스크립트 추가
Validation:
- npm run session:recover
Session-State: session recovery docs, template, and script are in place
Session-Next: apply this commit format to feature and refactor commits
Session-Risks: legacy commits before this change do not include session trailers
