This commit is contained in:
2026-04-21 12:45:08 +09:00
parent 6ae64d2a13
commit e63dc3efed
12 changed files with 267 additions and 325 deletions

View File

@@ -1,37 +1,38 @@
# Codex Working Rules
# Codex 작업 규칙
This file defines repo-specific rules that CODEX AI and future helpers should follow.
이 문서는 이 저장소에서 CODEX AI와 이후 작업자가 따라야 할 프로젝트 전용 규칙을 정리한다.
## Product Rules
## 제품 규칙
- Preserve the planner identity as a `10-minute planner diary`.
- Keep the default primary experience as `1 page + right-side information panel`.
- Keep `2 page spread` mode available unless the user explicitly removes it.
- Prefer calm paper-like layouts over generic dashboard styling.
- 이 프로젝트의 핵심 정체성은 `10분 플래너 다이어리`.
- 기본 사용 흐름은 `1페이지 + 우측 정보 패널`을 유지한다.
- `2페이지 펼침 보기`는 사용자가 명시적으로 제거하라고 하기 전까지 유지한다.
- 일반적인 대시보드 느낌보다 차분한 종이 다이어리 인상을 우선한다.
## Technical Rules
## 기술 규칙
- Use Vue for implementation.
- Use TailwindCSS for styling.
- Prefer reusable Vue components over large monolithic templates.
- Keep mock data easy to replace with real data sources later.
- Preserve responsive behavior for desktop and mobile.
- 구현은 Vue를 사용한다.
- 스타일링은 TailwindCSS를 사용한다.
- 큰 템플릿 하나보다 재사용 가능한 Vue 컴포넌트 구조를 우선한다.
- 현재 목업 데이터는 나중에 실제 데이터 소스로 교체하기 쉽게 유지한다.
- 타입스크립트는 사용하지 않고, Vue + JavaScript 기준으로 유지한다.
- 데스크톱과 모바일 모두에서 레이아웃이 무너지지 않도록 반응형 동작을 유지한다.
## Workflow Rules
## 작업 규칙
- Use local Git versioning continuously during development.
- Record meaningful product or technical notes in `HANDOFF.md`.
- Do not remove user-authored notes from `HANDOFF.md` unless they are outdated and replaced.
- When a major change is made, update both code and handoff context together.
- 개발 중에는 로컬 Git 버전 관리를 계속 유지한다.
- 중요한 제품/기술 메모는 `HANDOFF.md`에 기록한다.
- 구현 대기열과 진행 상황 관리는 `TODO.md`를 기준으로 한다.
- 사용자가 직접 남긴 메모는, 더 최신 정보로 대체되는 경우가 아니면 함부로 삭제하지 않는다.
- 큰 변경이 있을 때는 코드만 바꾸지 말고 인수인계 문서도 함께 갱신한다.
## Commit Rules
## 커밋 규칙
- Use semantic version style commits starting from `v0.0.1` when the user asks for versioned checkpoints.
- Prefer small, understandable checkpoints over large ambiguous commits.
- 사용자가 버전형 체크포인트를 원할 경우 `v0.0.1` 같은 형식으로 커밋을 남긴다.
- 의미를 알기 어려운 큰 커밋보다, 이해 가능한 작은 단위의 커밋을 선호한다.
## Design Implementation Rules
- Use the provided Figma files as the visual source of truth.
- Match the overall proportions, line rhythm, and typography feel of the diary layout.
- Add new UI around the planner only when it clearly supports navigation, planning, or review.
## 디자인 구현 규칙
- 제공된 Figma 파일을 시각적 기준점으로 사용한다.
- 다이어리 레이아웃의 비율감, 선의 리듬, 타이포그래피 분위기를 최대한 유지한다.
- 플래너 주변의 추가 UI는 이동, 계획, 회고에 실제로 도움이 되는 경우에만 늘린다.