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:
@@ -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`
|
||||||
|
|||||||
@@ -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
35
docs/session_brief.md
Normal 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`
|
||||||
@@ -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. 최종 보고에는 아래를 포함한다.
|
||||||
- 작업별 반영 내용
|
- 작업별 반영 내용
|
||||||
- 실행한 검증 결과
|
- 실행한 검증 결과
|
||||||
- 생성된 커밋 해시/제목 목록
|
- 생성된 커밋 해시/제목 목록
|
||||||
|
|||||||
Reference in New Issue
Block a user