Growth Loop - Product Documentation¶

The execution engine that turns your Life Blueprint into daily actions, weekly reflections, and purposeful progress.

Version 4.1 · Last updated May 2026 (revised — Reflect tab removed; per-goal weekly focus + reflection added (PR51); daily insights i18n via useTranslatedData; 2-tab layout: Today + Goals) Route: /growth-loop - Page: DailyGrowthPage.tsx Gate: requires Discovery + Mind & Body + Money Plan + Life Design completed Unlocks: Relationship Lens (with paid plan)

1. What Is the Growth Loop?¶

The Growth Loop is Stage 4: Execution of the MindMeditate Personality System - where your plan becomes your behaviour.

The Personality Test tells you who you are. Life Design tells you where you are going. Growth Loop is how you actually get there.

It is a 2-tab execution studio: - Today — Dashboard showing streak, weekly intention, daily archetype insight, and alignment trend - Goals — Your 6-pillar goal cards with tasks, due dates, and per-goal weekly focus + reflection

Reflect tab removed (May 2026). The global weekly reflection tab has been replaced by per-goal weekly focus and reflection cards directly on each goal in the Goals Kanban. Historical reflection data (growthLoop.weeklyReflections[]) is preserved in MongoDB but is no longer written by the UI.

2. How It Fits the Journey¶

Personality Test > Mind & Body > Money Plan > Life Design > Growth Loop > People Blueprint
   (Who)         (Foundation)   (Foundation)  (Direction)    (Execution)      (Relationships)

Stage	Output
Personality Test	Archetype + Force + Secondary
Self Mastery	Coach-style reflection on your profile
Life Design	Vision, Ikigai, pillars with goal cards (Milestone/Habit/Ritual/Skill/Relationship)
Growth Loop	Execute your goal cards through tasks, track weekly, build streaks

Growth Loop consumes everything Life Design produces: - Vision + Mission -> shown as North Star in Reflect tab - Pillar anchors -> shown as Alignment Anchors during weekly reflection - 6 pillars goals -> surfaced in Goals Kanban (each with type: Milestone/Habit/Ritual/Skill/Relationship) - Capability Gap -> shown as a goal in Growth Loop

Entry point from Life Design. After any AI-drafted pillar goal lands in Life Blueprint, a green banner appears in Life Blueprint confirming the goals are live here, with a direct "Open Growth Loop →" link. This makes the automatic connection visible without requiring users to navigate manually.

3. The Two Tabs¶

#	Tab	Purpose
1	Today	Dashboard — streak, weekly intention, daily insight, alignment trend
2	Goals	Goals Kanban — 6 pillars with goal cards, tasks, and per-goal weekly focus/reflection

Tab 1: Today (Overview)¶

Purpose. The command centre. Everything you need to see at a glance: am I on track?

What it shows: - Streak counter — current streak count for consecutive active days - Weekly intention summary — focus and 3 actions for this ISO week - Daily Archetype Insight card — archetype-specific tip that rotates by day-of-year. Loaded via useTranslatedData('dailyInsights') — Malay/Chinese/Tamil users see translated content (i18n fix, May 2026) - Alignment trend — chart showing alignment scores over time (from per-goal weekly reflections)

Why it is tab 1. It forces the user to see state before taking action — no ambiguity about how they are doing.

Tab 2: Goals (Kanban)¶

Purpose. Keep your 6 pillars goals visible and moving. The bridge between Life Blueprint intent and daily execution.

Source of goals. Goals are pulled from the 6 pillars in Life Blueprint:

Pillar	Goal Source	Editable?
Faith and Purpose	`lifeDesign.pillars.goals.faith`	Yes
Health and Vitality	`wellnessProfile.goals`	Read-only
Family and Relationships	`lifeDesign.pillars.goals.family`	Yes
Career and Impact	`lifeDesign.pillars.goals.career`	Yes
Finances	`financialPlan.goals`	Read-only
Growth and Mindset	`lifeDesign.pillars.goals.growth`	Yes

Goal Card Types (AI draft type):

Type	Icon	Description
Milestone		Major achievement or checkpoint
Habit		Daily/weekly behavior to build
Ritual		Regular practice or routine
Skill		Capability to develop
Relationship		People connection goal

Board columns. Goals move through: - Not Started > In Progress > Done

Goal cards. Each card shows: - Goal title - Pillar label - Goal type (Milestone/Habit/Ritual/Skill/Relationship) - Due date (derived from targetDate) - Progress indicator based on task completion

Task lists. Each goal card expands into a task list: - Add tasks with title and optional due date - Click to toggle completed state - Overdue tasks show a warning badge - Task due dates capped to the goal target date

Per-goal weekly focus (PR51, May 2026). Each goal card has a collapsible "What am I creating this week?" block: - focus — what the user commits to producing this week for this goal - why — brief motivation note - weekKey — ISO week identifier (e.g. 2026-W22)

Auto-expands for in-progress goals that have no focus set yet. Collapses once filled.

Per-goal weekly reflection (PR51, May 2026). Each goal card has a 3-question reflection section that replaces the old global Reflect tab: - q1 — What went well toward this goal? - q2 — What got in the way? - q3 — What will I do differently? - alignmentScore — 0–100 slider: how aligned was this week's work with your life blueprint? - weekKey — ISO week identifier - savedAt — timestamp

Weekly rhythm badges. Each goal card shows one of three rhythm states: - Set Focus — no focus set for current week - Reflect — focus is set but reflection not yet done - Week Done — both focus and reflection saved for this week

Capability Gap is surfaced as a goal card (Skill type) so you can track your progress on the one skill that gates your vision.

Tab 3: Reflect (removed May 2026)¶

The global weekly Reflect tab has been removed. Per-goal weekly focus + reflection (see Tab 2 above) replaces it. The North Star banner (Vision/Mission) and Alignment Anchors are now visible in the per-goal reflection sections.

Historical reflection data in growthLoop.weeklyReflections[] is preserved in MongoDB — not deleted, just no longer written by the UI. The Weekly Intention (focus + why + 3 actions) was also part of the Reflect tab and has been removed as a standalone feature.

4. The Weekly Intention¶

Set at the end of each Reflect session (or updated any time from the Reflect tab).

Fields:

Field	Meaning
Focus	The single thing that matters this week
Why	Why it matters this week (ties back to vision)
Actions[3]	Three concrete actions that would make it real
weekKey	ISO week identifier (auto-computed, e.g. 2026-W15)

Why three actions, not one? One action is too binary (did it / did not). Three creates a pattern - you almost always hit 1 or 2, which is the signal of a real week, not the pass/fail of a perfectionist week.

5. Streaks and Gamification¶

Streak definition. A day counts as active if the user completes at least one task under any goal card. The streak counter increments for consecutive active days.

Streak freezes. Limited tokens. A missed day consumes a freeze instead of breaking the streak.

Milestones. Fire on 7, 14, 21, 30, 60, 90 days. Each milestone: - Awards XP via applyXp() - Computes new badges via computeNewBadges() - Triggers a celebration modal

6. Data Model¶

interface GrowthLoopData {
  weeklyReflections: WeeklyReflection[];   // legacy, preserved but no longer written
  goalKanban: Record<goalId, GoalKanbanCard>;  // execution state per goal
  weeklyIntention?: {                       // legacy, preserved if set
    weekKey: string;
    focus: string;
    why: string;
    actions: [string, string, string];
  };
  streak: { count, lastActiveDate, freezesUsed };
  xp: number;
  badges: string[];
}

interface GoalKanbanCard {
  id: string;                              // matches pillar goal id
  status: 'not-started' | 'in-progress' | 'done';
  tasks: { id, title, completed, dueDate? }[];
  goalDueDate?: string;                    // ISO date YYYY-MM-DD
  weeklyFocus?: {                          // PR51 — per-goal, per-week focus
    focus: string;
    why: string;
    weekKey: string;                       // e.g. '2026-W22'
  };
  weeklyReflection?: {                     // PR51 — per-goal, per-week reflection
    q1: string;
    q2: string;
    q3: string;
    alignmentScore: number;               // 0-100
    weekKey: string;
    savedAt: string;                      // ISO timestamp
  };
}

Goals flow from Life Design 6 pillars: - Goals are stored in pillars.goals.{faith,family,career,growth} (editable) - Health goals: mirrored from wellnessProfile.goals (read-only) - Finances goals: mirrored from financialPlan.goals (read-only) - Each goal has a type: Milestone/Habit/Ritual/Skill/Relationship - Capability Gap: surfaced as a goal card from lifeDesign.capabilityGap

7. AI Coach (floating chat)¶

The AI Coach button inside Growth Loop has a coach persona focused on execution honesty - not motivation.

It has access to: - Current goals and tasks (by pillar and type) - Recent reflections (spot patterns) - Current weekly intention (context for commitments)

Sample seeded questions: - Which goal am I avoiding, and is it the most important one? - Are my actions this week aligned with my Life Blueprint? - Where are my weekly reflections staying on the safe side of the truth?

8. Design Principles¶

Consumes Life Design, never duplicates it. Every goal, every pillar is inherited. Growth Loop never asks the user to re-define direction - only to execute it.
See before you log. Today is tab 1 for a reason. The user sees state first, then acts.
Goals contain all types. Habit, Skill, Milestone, Ritual, Relationship - all are goal cards. No separate trackers.
Three actions, not one. Binary goals are brittle; trios produce signal-rich weeks.
Goals are visible, not hidden. The Goals Kanban keeps long-horizon priorities permanently visible.

9. Glossary¶

Term	Definition
Goal Kanban	Board of goal cards from 6 pillars with task lists, statuses, and due dates
Goal Type	AI draft type: Milestone, Habit, Ritual, Skill, Relationship
Weekly Intention	The single focus + why + 3 actions committed to for the coming week
Alignment Score	Weekly self-rating of how aligned the week was with vision + path
Habit Score	Auto-computed percentage of task completions for the week
Streak	Consecutive active days (at least one task completed)
Capability Gap	The one skill that gates the vision (from Life Design, surfaced as a Skill goal card)
Growth Loop	The execution engine that turns your Life Blueprint into daily actions, weekly reflections, and purposeful progress
North Star	The vision and mission from your Life Design — shown during reflection to anchor your thinking
Alignment Anchors	Your Life Design pillar anchors — used as a reminder grid during weekly reflection

10. Design Principles (Summary)¶

Consumes Life Design, never duplicates it. Every goal, every pillar is inherited. Growth Loop never asks the user to re-define direction — only to execute it.
See before you log. Today is tab 1 for a reason. The user sees state first, then acts.
Goals contain all types. Habit, Skill, Milestone, Ritual, Relationship — all are goal cards. No separate trackers.
Three actions, not one. Binary goals are brittle; trios produce signal-rich weeks.
Goals are visible, not hidden. The Goals Kanban keeps long-horizon priorities permanently visible.
Insight before action. The Reflect tab runs before the Weekly Intention — honest diagnosis before commitment.
Streaks reward consistency, not perfection. The streak system includes freeze tokens so users can miss a day without losing momentum.

11. FAQ¶

Q: Do I have to do all three tabs every day? No. Only Goals is ongoing. Reflect (Weekly Reflection + Intention) is weekly. Today is for scanning anytime.

Q: What happened to the Habit Tracker and Skills Tracker? They have been removed. Habits and Skills are now goal card types inside each pillar. A Milestone goal type marks major achievements, a Habit goal type marks daily behaviors, a Skill goal type marks capabilities to develop.

Q: How are goals organized? Goals are organized by the 6 pillars from Life Design: Faith, Health, Family, Career, Finances, Growth. Each pillar shows its goal cards in a column. You can filter by goal type (Milestone/Habit/Ritual/Skill/Relationship).

Q: How do goal due dates work? Goal due dates come from the targetDate field on each goal card. Task due dates within a goal are capped to the goal target date.

Q: Does Growth Loop push notifications? Not yet - it is pull-based (the user opens it). Push notifications are on the roadmap.

Q: How does the AI Coach work in Growth Loop? The AI Coach inside Growth Loop has read your current goals, recent reflections, and weekly intention. It uses this context to provide personalized coaching on execution honesty — helping you identify patterns in your progress and recommit to your stated intentions.

Q: What is the relationship between the Capability Gap and Growth Loop? The Capability Gap identified in Life Design (the one skill that gates your vision) is surfaced as a Skill goal card in Growth Loop. This makes it a tracked, actionable goal rather than an abstract concept.

Q: What triggers XP rewards? - Completing a weekly reflection: +100 XP - Reaching a streak milestone (7/14/21/30/60/90 days): +150 XP - First reflection ever: ⚔️ Week 1 Warrior badge - 7-day streak: 🔥 Habit Builder badge

📝 Content Backlog (documentation edits only)¶

[ ] Add screenshots of each tab
[ ] Translate to Bahasa Malaysia

🛠️ Product Roadmap (features to build)¶

[ ] Push notifications for weekly reflection reminders
[ ] Cross-product integration with Self Mastery — convert act2 commitment into a tracked habit
[ ] Export weekly intention to calendar
[ ] AI-generated weekly summary based on task completion and reflection patterns