corpi
f0efd74af3
맥락: - 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 갱신이 누락되면 복구 정확도가 떨어질 수 있음
82 lines
2.5 KiB
Markdown
82 lines
2.5 KiB
Markdown
# WorkFlow
|
|
|
|
너는 이 레포의 유지보수 엔지니어다.
|
|
사용자가 `workFlow.md를 실행해`라고 지시하면 아래 순서대로 수행한다.
|
|
|
|
## 0) 입력 확인
|
|
|
|
1. `docs/work.md`를 읽고 작업 목록을 파악한다.
|
|
2. 비어 있거나 모호한 항목이 있으면 최소 질문 1회로 명확히 한다.
|
|
|
|
## 1) 필수 컨텍스트 로드
|
|
|
|
토큰 절약을 위해 기본 로드 + 조건부 로드로 나눠서 읽는다.
|
|
|
|
### 기본 로드 (항상)
|
|
|
|
- `docs/work.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) 구현 원칙 (강제)
|
|
|
|
- FSD 레이어 규칙을 지킨다.
|
|
- `page.tsx`에는 조합만 두고 비즈니스 로직을 넣지 않는다.
|
|
- UI 상태(토글/선택)만 최소 허용한다.
|
|
- 파일 500줄 이상이면 분리한다.
|
|
- 실제 기능(타이머/오디오/서버/DB) 구현은 하지 않고 UI 목업 + 더미 + 토스트로 처리한다.
|
|
- 작업 지시 범위를 벗어난 파일은 수정하지 않는다.
|
|
|
|
## 3) 실행 순서
|
|
|
|
1. `work.md`의 `작업 1`부터 처리한다.
|
|
2. 작업 단위마다 아래를 수행한다.
|
|
- 코드 수정
|
|
- 검증 실행 (`work.md`의 검증 항목 우선)
|
|
- 요구사항 충족 여부 자체 점검
|
|
3. 여러 작업이 있으면 동일 절차를 반복한다.
|
|
|
|
## 4) 커밋 규칙 (강제)
|
|
|
|
- 주제별 1커밋 원칙을 지킨다.
|
|
- 커밋 메시지는 한국어로 작성한다.
|
|
- 형식은 `Conventional Commits`를 따른다.
|
|
- 예: `feat(app): 허브 CTA를 데스크톱 컴팩트 그룹으로 변경`
|
|
- 커밋 본문은 아래 구조를 사용한다.
|
|
|
|
```text
|
|
맥락:
|
|
- ...
|
|
|
|
변경사항:
|
|
- ...
|
|
|
|
검증:
|
|
- ...
|
|
|
|
세션-상태: ...
|
|
세션-다음: ...
|
|
세션-리스크: ...
|
|
```
|
|
|
|
- 커밋에는 관련 파일만 스테이징한다.
|
|
|
|
## 5) 종료 정리
|
|
|
|
1. `docs/90_current_state.md` 업데이트
|
|
- DONE / NEXT / RISKS / CHANGED FILES
|
|
2. `docs/session_brief.md`를 최신 상태로 압축 갱신
|
|
- 현재 우선순위 / 최근 세션 상태 / 리스크
|
|
3. 최종 보고에는 아래를 포함한다.
|
|
- 작업별 반영 내용
|
|
- 실행한 검증 결과
|
|
- 생성된 커밋 해시/제목 목록
|