planner.sori.studio/AGENTS.md

Codex 작업 규칙

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

제품 규칙

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

기술 규칙

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

작업 규칙

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

커밋 규칙

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

디자인 구현 규칙

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