planner.sori.studio/AGENTS.md

Codex Working Rules

This file defines repo-specific rules that CODEX AI and future helpers should follow.

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.

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.

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.

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.

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.