Files

corpi 28ed1841ca docs(workflow): work.md 기반 실행 절차 문서 추가

맥락:

- 작업 지시를 문서 기반으로 표준화하고, 실행 시 규칙 준수와 주제별 커밋을 강제하기 위해

변경사항:

- docs/work.md에 작업 입력 템플릿 추가

- docs/workFlow.md에 실행 순서, 규칙 준수, 커밋 절차 명시

- docs/README.md에 work/workFlow 문서 링크 추가

검증:

- 문서 내용 수동 검토

세션-상태: 문서 기반 작업 지시/실행 체계가 준비됨

세션-다음: 이후 작업부터 work.md 작성 후 workFlow.md 실행

세션-리스크: work.md가 비어 있으면 실행 전에 추가 확인이 필요

2026-02-27 13:39:16 +09:00

2.0 KiB

Raw Blame History

WorkFlow

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

0) 입력 확인

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

1) 필수 컨텍스트 로드

작업 시작 전에 아래 문서를 읽고 규칙을 고정한다.

docs/00_project_brief.md
docs/01_ui_guidelines.md
docs/02_arch_fsd_rules.md
docs/04_coding_rules.md
docs/06_commit_convention.md
docs/90_current_state.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
최종 보고에는 아래를 포함한다.
- 작업별 반영 내용
- 실행한 검증 결과
- 생성된 커밋 해시/제목 목록

2.0 KiB Raw Blame History

WorkFlow

0) 입력 확인

1) 필수 컨텍스트 로드

2) 구현 원칙 (강제)

3) 실행 순서

4) 커밋 규칙 (강제)

5) 종료 정리

2.0 KiB

Raw Blame History