diff --git a/docs/90_current_state.md b/docs/90_current_state.md index c5c5982..299deab 100644 --- a/docs/90_current_state.md +++ b/docs/90_current_state.md @@ -10,6 +10,9 @@ Last Updated: 2026-02-27 - 워크플로우 토큰 절약 모드 추가: - `docs/context_core.md` 신설 - `docs/workFlow.md`를 기본 3문서 + 조건부 로드로 변경 +- 워크플로우 기본 로드를 2파일로 축소: + - `docs/work.md` + - `docs/session_brief.md` - 복구 스크립트 추가: - `scripts/session/recover-context.sh` - `npm run session:recover` 명령 추가 @@ -39,6 +42,7 @@ Last Updated: 2026-02-27 - `docs/06_commit_convention.md` - `docs/07_session_recovery.md` - `docs/context_core.md` +- `docs/session_brief.md` - `docs/workFlow.md` - `docs/README.md` - `.gitmessage-session.txt` diff --git a/docs/README.md b/docs/README.md index b1b4f3b..9df36f0 100644 --- a/docs/README.md +++ b/docs/README.md @@ -4,12 +4,10 @@ Codex CLI가 중간에 끊겨도 같은 품질로 작업을 이어가기 위한 ## 우선 읽기 순서 -1. [00_project_brief.md](./00_project_brief.md) -2. [01_ui_guidelines.md](./01_ui_guidelines.md) -3. [02_arch_fsd_rules.md](./02_arch_fsd_rules.md) -4. [03_routes_map.md](./03_routes_map.md) -5. [90_current_state.md](./90_current_state.md) -6. [context_core.md](./context_core.md) +1. [work.md](./work.md) +2. [session_brief.md](./session_brief.md) +3. [90_current_state.md](./90_current_state.md) +4. [context_core.md](./context_core.md) ## 추가 실무 가이드 @@ -19,6 +17,7 @@ Codex CLI가 중간에 끊겨도 같은 품질로 작업을 이어가기 위한 - [07_session_recovery.md](./07_session_recovery.md) - [work.md](./work.md) - [workFlow.md](./workFlow.md) +- [session_brief.md](./session_brief.md) ## 운영 원칙 @@ -26,4 +25,4 @@ Codex CLI가 중간에 끊겨도 같은 품질로 작업을 이어가기 위한 - `page.tsx`는 조합만 담당하고 비즈니스 로직은 `features/widgets/entities`로 이동한다. - 작업 종료 시 `90_current_state.md`를 반드시 업데이트한다. - 세션 복구는 `npm run session:recover`로 시작한다. -- `workFlow.md` 실행 시 기본은 `work + 90_current_state + context_core`만 로드한다. +- `workFlow.md` 실행 시 기본은 `work + session_brief` 2파일만 로드한다. diff --git a/docs/session_brief.md b/docs/session_brief.md new file mode 100644 index 0000000..fa7c927 --- /dev/null +++ b/docs/session_brief.md @@ -0,0 +1,35 @@ +# Session Brief + +Last Updated: 2026-02-27 + +세션 시작 시 항상 읽는 초소형 스냅샷 문서. + +## 고정 규칙 (요약) + +- 구현 범위는 UI 목업 + 더미 데이터 + 토스트로 제한한다. +- `page.tsx`는 조합만 담당한다. +- 비즈니스 로직은 `features/entities`로 이동한다. +- 파일이 500줄 이상이면 분리한다. +- 커밋은 주제별 1커밋, 한국어 Conventional Commit으로 작성한다. + +## 현재 우선순위 + +1. `/space` 상단의 인원 수 카피를 분위기형 카피로 전환 +2. `RoomSheetWidget`/도크 패널의 인원 수 UI를 큐레이션형으로 재정의할지 결정 + +## 최근 세션 상태 + +- 세션 복구용 문서/템플릿/스크립트가 준비되어 있다. +- `workFlow.md`는 토큰 절약 모드를 사용한다. +- 이후 작업은 `docs/work.md`를 기준으로 실행한다. + +## 리스크 + +- 네트워크 제한 환경에서는 `npm run build` 시 Google Fonts fetch 실패 가능 +- 작업 범위가 넓을 때 커밋 단위가 커질 수 있으므로 주제 분리 점검 필요 + +## 상세 원문 위치 + +- 장문 상세 상태: `docs/90_current_state.md` +- 구조 규칙 상세: `docs/02_arch_fsd_rules.md` +- 커밋 규칙 상세: `docs/06_commit_convention.md` diff --git a/docs/workFlow.md b/docs/workFlow.md index 692ef97..ec81a0b 100644 --- a/docs/workFlow.md +++ b/docs/workFlow.md @@ -15,14 +15,15 @@ ### 기본 로드 (항상) - `docs/work.md` -- `docs/90_current_state.md` -- `docs/context_core.md` +- `docs/session_brief.md` ### 조건부 로드 (필요할 때만) - UI/카피/CTA 변경이 있으면 `docs/01_ui_guidelines.md` - 구조/FSD/레이어 변경이 있으면 `docs/02_arch_fsd_rules.md` - 커밋 직전에 `docs/06_commit_convention.md` +- 현재 상태 상세가 필요하면 `docs/90_current_state.md` +- 핵심 규칙 상세가 필요하면 `docs/context_core.md` - 규칙 충돌/모호함이 있으면 `docs/00_project_brief.md`, `docs/04_coding_rules.md` ## 2) 구현 원칙 (강제) @@ -72,7 +73,9 @@ 1. `docs/90_current_state.md` 업데이트 - DONE / NEXT / RISKS / CHANGED FILES -2. 최종 보고에는 아래를 포함한다. +2. `docs/session_brief.md`를 최신 상태로 압축 갱신 + - 현재 우선순위 / 최근 세션 상태 / 리스크 +3. 최종 보고에는 아래를 포함한다. - 작업별 반영 내용 - 실행한 검증 결과 - 생성된 커밋 해시/제목 목록