Files

corpi 91fce428ec docs(workflow): 컨텍스트 로드를 토큰 절약 모드로 전환

맥락:

- 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 입력이 장문이면 절감 효과가 상대적으로 줄어들 수 있음

2026-02-27 13:46:27 +09:00

1.3 KiB

Raw Blame History

Context Core (Token-Saving)

세션 시작 시 가장 먼저 읽는 핵심 요약본이다.

제품/범위

VibeRoom Web은 UI 목업 중심 프로젝트다.
실제 기능(타이머 카운트다운, 오디오 엔진, 서버/DB)은 구현하지 않는다.
더미 데이터 + 토스트 + 화면 상호작용 중심으로 구현한다.

FSD 핵심 규칙

app/page.tsx는 조합만 담당한다.
비즈니스 로직은 features 또는 entities로 이동한다.
UI 상태(토글/선택)만 최소 허용한다.
파일이 500줄 이상이면 분리한다.
import 방향:
- app -> widgets/features/entities/shared
- widgets -> features/entities/shared
- features -> entities/shared
- entities -> shared
- shared -> shared/external

UI 핵심 규칙

톤: 감성/저자극, 과한 대비/강조 금지
CTA 위계: Primary 1개 중심, Secondary/Tertiary는 무게 낮게
모바일은 접근성 우선, 데스크톱은 과한 풀폭 버튼 지양

커밋 규칙 (요약)

주제별 1커밋
한국어 Conventional Commit
본문 형식:
- 맥락
- 변경사항
- 검증
- 세션-상태 / 세션-다음 / 세션-리스크

세션 복구 규칙

시작: npm run session:recover
상태판: docs/90_current_state.md 기준으로 다음 작업 결정

1.3 KiB Raw Blame History

Context Core (Token-Saving)

제품/범위

FSD 핵심 규칙

UI 핵심 규칙

커밋 규칙 (요약)

세션 복구 규칙

1.3 KiB

Raw Blame History