# Codex 작업 규칙

이 문서는 이 저장소에서 CODEX AI와 이후 작업자가 따라야 할 프로젝트 전용 규칙을 정리한다.

## 제품 규칙

- 이 프로젝트의 핵심 정체성은 `10분 플래너 다이어리`다.
- 기본 사용 흐름은 `1페이지 + 우측 정보 패널`을 유지한다.
- `2페이지 펼침 보기`는 사용자가 명시적으로 제거하라고 하기 전까지 유지한다.
- 일반적인 대시보드 느낌보다 차분한 종이 다이어리 인상을 우선한다.

## 기술 규칙

- 구현은 Vue를 사용한다.
- 스타일링은 TailwindCSS를 사용한다.
- 큰 템플릿 하나보다 재사용 가능한 Vue 컴포넌트 구조를 우선한다.
- 현재 목업 데이터는 나중에 실제 데이터 소스로 교체하기 쉽게 유지한다.
- 타입스크립트는 사용하지 않고, Vue + JavaScript 기준으로 유지한다.
- 데스크톱과 모바일 모두에서 레이아웃이 무너지지 않도록 반응형 동작을 유지한다.

## 작업 규칙

- 개발 중에는 로컬 Git 버전 관리를 계속 유지한다.
- 중요한 제품/기술 메모는 `HANDOFF.md`에 기록한다.
- 구현 대기열과 진행 상황 관리는 `TODO.md`를 기준으로 한다.
- 사용자가 직접 남긴 메모는, 더 최신 정보로 대체되는 경우가 아니면 함부로 삭제하지 않는다.
- 큰 변경이 있을 때는 코드만 바꾸지 말고 인수인계 문서도 함께 갱신한다.

## 커밋 규칙

- 사용자가 버전형 체크포인트를 원할 경우 `v0.0.1` 같은 형식으로 커밋을 남긴다.
- 버전 커밋만 단독으로 쓰지 말고, `v0.1.7 - 저장 레이어 분리`처럼 버전 뒤에 작업 요약을 함께 남긴다.
- 의미를 알기 어려운 큰 커밋보다, 이해 가능한 작은 단위의 커밋을 선호한다.

## 디자인 구현 규칙

- 제공된 Figma 파일을 시각적 기준점으로 사용한다.
- 다이어리 레이아웃의 비율감, 선의 리듬, 타이포그래피 분위기를 최대한 유지한다.
- 플래너 주변의 추가 UI는 이동, 계획, 회고에 실제로 도움이 되는 경우에만 늘린다.