docs(workflow): 기본 컨텍스트 로드를 2파일로 축소

맥락:

- 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 갱신이 누락되면 복구 정확도가 떨어질 수 있음
This commit is contained in:
2026-02-27 13:50:10 +09:00
parent 91fce428ec
commit f0efd74af3
4 changed files with 51 additions and 10 deletions

View File

@@ -10,6 +10,9 @@ Last Updated: 2026-02-27
- 워크플로우 토큰 절약 모드 추가: - 워크플로우 토큰 절약 모드 추가:
- `docs/context_core.md` 신설 - `docs/context_core.md` 신설
- `docs/workFlow.md`를 기본 3문서 + 조건부 로드로 변경 - `docs/workFlow.md`를 기본 3문서 + 조건부 로드로 변경
- 워크플로우 기본 로드를 2파일로 축소:
- `docs/work.md`
- `docs/session_brief.md`
- 복구 스크립트 추가: - 복구 스크립트 추가:
- `scripts/session/recover-context.sh` - `scripts/session/recover-context.sh`
- `npm run session:recover` 명령 추가 - `npm run session:recover` 명령 추가
@@ -39,6 +42,7 @@ Last Updated: 2026-02-27
- `docs/06_commit_convention.md` - `docs/06_commit_convention.md`
- `docs/07_session_recovery.md` - `docs/07_session_recovery.md`
- `docs/context_core.md` - `docs/context_core.md`
- `docs/session_brief.md`
- `docs/workFlow.md` - `docs/workFlow.md`
- `docs/README.md` - `docs/README.md`
- `.gitmessage-session.txt` - `.gitmessage-session.txt`

View File

@@ -4,12 +4,10 @@ Codex CLI가 중간에 끊겨도 같은 품질로 작업을 이어가기 위한
## 우선 읽기 순서 ## 우선 읽기 순서
1. [00_project_brief.md](./00_project_brief.md) 1. [work.md](./work.md)
2. [01_ui_guidelines.md](./01_ui_guidelines.md) 2. [session_brief.md](./session_brief.md)
3. [02_arch_fsd_rules.md](./02_arch_fsd_rules.md) 3. [90_current_state.md](./90_current_state.md)
4. [03_routes_map.md](./03_routes_map.md) 4. [context_core.md](./context_core.md)
5. [90_current_state.md](./90_current_state.md)
6. [context_core.md](./context_core.md)
## 추가 실무 가이드 ## 추가 실무 가이드
@@ -19,6 +17,7 @@ Codex CLI가 중간에 끊겨도 같은 품질로 작업을 이어가기 위한
- [07_session_recovery.md](./07_session_recovery.md) - [07_session_recovery.md](./07_session_recovery.md)
- [work.md](./work.md) - [work.md](./work.md)
- [workFlow.md](./workFlow.md) - [workFlow.md](./workFlow.md)
- [session_brief.md](./session_brief.md)
## 운영 원칙 ## 운영 원칙
@@ -26,4 +25,4 @@ Codex CLI가 중간에 끊겨도 같은 품질로 작업을 이어가기 위한
- `page.tsx`는 조합만 담당하고 비즈니스 로직은 `features/widgets/entities`로 이동한다. - `page.tsx`는 조합만 담당하고 비즈니스 로직은 `features/widgets/entities`로 이동한다.
- 작업 종료 시 `90_current_state.md`를 반드시 업데이트한다. - 작업 종료 시 `90_current_state.md`를 반드시 업데이트한다.
- 세션 복구는 `npm run session:recover`로 시작한다. - 세션 복구는 `npm run session:recover`로 시작한다.
- `workFlow.md` 실행 시 기본은 `work + 90_current_state + context_core`만 로드한다. - `workFlow.md` 실행 시 기본은 `work + session_brief` 2파일만 로드한다.

35
docs/session_brief.md Normal file
View File

@@ -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`

View File

@@ -15,14 +15,15 @@
### 기본 로드 (항상) ### 기본 로드 (항상)
- `docs/work.md` - `docs/work.md`
- `docs/90_current_state.md` - `docs/session_brief.md`
- `docs/context_core.md`
### 조건부 로드 (필요할 때만) ### 조건부 로드 (필요할 때만)
- UI/카피/CTA 변경이 있으면 `docs/01_ui_guidelines.md` - UI/카피/CTA 변경이 있으면 `docs/01_ui_guidelines.md`
- 구조/FSD/레이어 변경이 있으면 `docs/02_arch_fsd_rules.md` - 구조/FSD/레이어 변경이 있으면 `docs/02_arch_fsd_rules.md`
- 커밋 직전에 `docs/06_commit_convention.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` - 규칙 충돌/모호함이 있으면 `docs/00_project_brief.md`, `docs/04_coding_rules.md`
## 2) 구현 원칙 (강제) ## 2) 구현 원칙 (강제)
@@ -72,7 +73,9 @@
1. `docs/90_current_state.md` 업데이트 1. `docs/90_current_state.md` 업데이트
- DONE / NEXT / RISKS / CHANGED FILES - DONE / NEXT / RISKS / CHANGED FILES
2. 최종 보고에는 아래를 포함한다. 2. `docs/session_brief.md`를 최신 상태로 압축 갱신
- 현재 우선순위 / 최근 세션 상태 / 리스크
3. 최종 보고에는 아래를 포함한다.
- 작업별 반영 내용 - 작업별 반영 내용
- 실행한 검증 결과 - 실행한 검증 결과
- 생성된 커밋 해시/제목 목록 - 생성된 커밋 해시/제목 목록