Agentic Development Plan

Governing LLM (Claude) plans + reviews; specialist agents build; CHECKLIST.md is the single source of truth (update on every task; rebuild the HTML site after doc edits). Reuse the Udhaar Khata stack heavily (copy + adapt) — same conventions, same wa-hub + template store + sync + signing flow.

Agents / sequence

  1. Backend Architect → Node/Express + PG (port 8043): auth (OTP via wa-hub), me/entitlement, reminders CRUD + logs/streaks, grocery lists/items, family, billing (Razorpay, gated), sync, admin API, scheduler script (family miss-alerts, expiry WA, Pro WA reminders), wa_templates seed.
  2. Mobile App Builder → Flutter: Today/Reminders + List + Settings, local notifications, offline sync, Pro upsell, OTP login, icon via flutter_launcher_icons.
  3. Frontend/Admin → web admin SPA (/admin) + API wiring; landing page (/) + docs site generator.
  4. Reviews → correctness+security review + ponytail review → fix blockers.
  5. Release → deploy backend (systemd + nginx + SSL), build signed AAB+APK, Play assets, host.

Conventions (same rails)

  • wa-hub for WhatsApp (shared /root/.config/wa-hub.env); central wa_templates; NOT getaseed.
  • Entitlement enforced server-side; never trust client for Pro gates.
  • Secrets in root-only .env; JWT HS256; parameterized SQL; helmet; rate-limited hashed OTP.
  • On-device local notifications for reminders (no Firebase in v1); server only for WA/escalation.
  • Money in paise; subscriptions drive feature gates.

Build order → see CHECKLIST.md