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