viberoom-web/docs/ops/workFlow.md

WorkFlow

너는 이 레포의 유지보수 엔지니어다.
사용자가 workFlow.md를 실행해라고 지시하면 아래 순서대로 수행한다.

0) 입력 확인

1. docs/work.md를 읽고 작업 목록을 파악한다.
2. 비어 있거나 모호한 항목이 있으면 최소 질문 1회로 명확히 한다.

1) 필수 컨텍스트 로드

토큰 절약을 위해 기본 로드 + 조건부 로드로 나눠서 읽는다.

기본 로드 (항상)

• docs/work.md
• docs/session_brief.md

조건부 로드 (필요할 때만)

• UI/카피/CTA 변경이 있으면 docs/foundation/01_ui_guidelines.md
• 구조/FSD/레이어 변경이 있으면 docs/foundation/02_arch_fsd_rules.md
• 커밋 직전에 docs/foundation/06_commit_convention.md
• 현재 상태 상세가 필요하면 docs/90_current_state.md
• 핵심 규칙 상세가 필요하면 docs/context_core.md
• 규칙 충돌/모호함이 있으면 docs/foundation/00_project_brief.md, docs/foundation/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를 데스크톱 컴팩트 그룹으로 변경
• 커밋 본문은 아래 구조를 사용한다.

맥락:
- ...

변경사항:
- ...

검증:
- ...

세션-상태: ...
세션-다음: ...
세션-리스크: ...

• 커밋에는 관련 파일만 스테이징한다.

5) 종료 정리

1. docs/90_current_state.md 업데이트
   • DONE / NEXT / RISKS / CHANGED FILES
2. docs/session_brief.md를 최신 상태로 압축 갱신
   • 현재 우선순위 / 최근 세션 상태 / 리스크
3. 최종 보고에는 아래를 포함한다.
   • 작업별 반영 내용
   • 실행한 검증 결과
   • 생성된 커밋 해시/제목 목록