Skip to content

Project Management

Mission Control

This page tracks the high-level roadmap and active development tasks for ChatKcal. All work follows the v2.0 Project Management Protocol.

Workflow Protocol

Plan-First Protocol (v2.0)

  1. Define (Work Log / Daily Log)
  2. Plan (Context & Approach)
  3. STOP (User Approval: "Shall I proceed?")
  4. Execute (Implement)
  5. Verify & Close (Test, update Architecture Docs, & Close)

Master Plan & Roadmap

Phase 1: Foundation (Stable)

Goal: Robust technical architecture and end-to-end AI logging capability.

  • [Pre-Log] Core Architecture: AppSync + DynamoDB + Cognito.
  • [Pre-Log] Basic Tracking: Add/Get meals via AI.
  • [2025-12-30] Documentation & PM Setup: Setup MkDocs, protocol, and custom PM skill. Status View Log
  • [2026-01-01] Layered Testing Strategy: Unit (Vitest) and Integration (RTL/Playwright). Status View Log
  • [2026-01-03] Data Standardisation: camelCase, Floats, and Version 4 schema. Status View Log
  • [2026-01-05] TypeScript Migration: Full type safety across the frontend. Status View Log
  • [2026-01-06] Advanced Nutrient Tracking: Support for Fiber, Sodium, and custom nutrients. Status View Log
  • [2026-01-17] Protocol v2.0: Implementation of rolling logs, STOP trigger, and state vs. transition rules. Status View Log
Completed Phase 1 History
  • [2026-01-17] Documentation Audit: Audit doc structure and establish healthcheck. View Log
  • [2026-01-10] Prompt Engineering Uplift: Refine instructions and iPhone copy-paste. View Log
  • [2026-01-05] Refactor Codebase (Post-TS): Polish types, remove any. View Log
  • [2026-01-05] Date Selector in Menu: Log for past/future dates. View Log
  • [2026-01-05] Fix Dev Env: Connect Dev App to Dev Backend. View Log
  • [2026-01-05] Fix Delete Resolver: Fix DynamoDB UpdateExpression. View Log
  • [2026-01-04] Fix API Meal Service: Dashboard TypeError fix. View Log
  • [2026-01-01] Targets Persistence: Store/retrieve calorie targets. View Log
  • [2025-12-30] Offline Capability: (Moved to Phase 2, but started here). View Log

Phase 2: Onboarding & First User Experience (Current Focus)

Goal: Make the journey from "Zero to First Logged Meal" frictionless and delightful.

  • Guest Mode Architecture: Design technical support for offline/unauthenticated logging. Status View Log
  • Guest Mode (Backend): Implement importGuestHistory Lambda & Resolver.
  • Guest Mode (Frontend): Implement LocalMealService & Service Injection.
  • Guest Mode (QA): Implement Layer 4 Network Integration Tests.
  • First-Log Experience Design: Optimise the flow from deep-link or manual entry to the first "Aha!" moment. Status View Log
  • [2025-12-30] Offline Capability: Initial PWA + React Query implementation. Status View Log
  • Visual Hierarchy (Calorie Focus): Adjust dashboard to emphasise calories as the primary metric.
  • [2026-01-14] Progress Bar Contrast: Fix text readability when exceeding daily targets. Status View Log
  • [2026-01-08] UI Polish & Bug Fixes: Fix "Flash of Zero" and sticky expansion bugs. Status View Log

Phase 3: Core Utility (The "Loop")

Goal: Close the loop between action (eating) and outcome (health).

  • Data Aggregation: Implement DaySummary logic (DynamoDB TransactWriteItems).
  • Outcome Tracking: Weight logging and trend smoothing.
  • History: "Unique Days" calendar and detailed history browsing.

Phase 4: Friction Zero (Retention)

Goal: Make logging faster than thought.

  • Quick Add: Non-AI manual entry for simple items.
  • Recents & Favorites: One-tap logging for habitual meals.
  • Smart Reminders: Context-aware notifications.
  • State Persistence: Design strategy for preserving UI state (modals, date selection) across reloads.

Phase 5: Cross-Platform & Native

Goal: Native presence and device integration.

  • Mobile Apps: Capacitor wrapper for iOS/Android.
  • Deep Integration: HealthKit/Google Fit sync, Haptics, Widgets.