Files
HouseHoldKeaper/.planning/REQUIREMENTS.md

2.6 KiB

Requirements: HouseHoldKeaper

Defined: 2026-03-16 Core Value: Users can see what needs doing today, mark it done, and trust the app to schedule the next occurrence — without thinking about it.

v1.1 Requirements

Requirements for milestone v1.1 Calendar & Polish. Each maps to roadmap phases.

Calendar UI

  • CAL-01: User sees a horizontal scrollable date-strip with day abbreviation (Mo, Di...) and date number per card
  • CAL-02: User can tap a day card to see that day's tasks in a list below the strip
  • CAL-03: User sees a subtle color shift at month boundaries for visual orientation
  • CAL-04: Calendar strip auto-scrolls to today on app launch
  • CAL-05: Undone tasks carry over to the next day with a red/orange color accent marking them as overdue

Task History

  • HIST-01: Each task completion is recorded with a timestamp
  • HIST-02: User can view past completion dates for any individual task

Task Sorting

  • SORT-01: User can sort tasks alphabetically
  • SORT-02: User can sort tasks by frequency interval
  • SORT-03: User can sort tasks by effort level

Future Requirements

Deferred to future release. Tracked but not in current roadmap.

Data

  • DATA-01: User can export all data as JSON
  • DATA-02: User can import data from JSON backup

Localization

  • LOC-01: User can switch UI language to English

Rooms

  • ROOM-01: User can set a cover photo for a room from camera or gallery

Out of Scope

Explicitly excluded. Documented to prevent scope creep.

Feature Reason
Weekly/monthly calendar views Overcomplicates UI — date strip is sufficient for task app
Drag tasks between days Not needed — tasks auto-schedule based on frequency
Calendar sync (Google/Apple) Contradicts local-first, offline-only design
Task statistics/charts Deferred to v2.0 — history log is the foundation

Traceability

Which phases cover which requirements. Updated during roadmap creation.

Requirement Phase Status
CAL-01 Phase 5 Pending
CAL-02 Phase 5 Pending
CAL-03 Phase 5 Pending
CAL-04 Phase 5 Pending
CAL-05 Phase 5 Pending
HIST-01 Phase 6 Pending
HIST-02 Phase 6 Pending
SORT-01 Phase 7 Pending
SORT-02 Phase 7 Pending
SORT-03 Phase 7 Pending

Coverage:

  • v1.1 requirements: 10 total
  • Mapped to phases: 10
  • Unmapped: 0

Requirements defined: 2026-03-16 Last updated: 2026-03-16 after roadmap creation (phases 5-7)