From 6e1945e8a04206cb3cf92df64bdefe15a87fefd1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marc-Andr=C3=A9=20Bombeck?= <mbombeck@gmail.com>
Date: Sun, 19 Jul 2026 14:59:24 +0200
Subject: [PATCH] docs(workouts): correct the seam comments now that the card
 can mount

---
 src/app/insights/workouts/[id]/page.tsx | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/app/insights/workouts/[id]/page.tsx b/src/app/insights/workouts/[id]/page.tsx
index c5216de72..2061211c0 100644
--- a/src/app/insights/workouts/[id]/page.tsx
+++ b/src/app/insights/workouts/[id]/page.tsx
@@ -91,9 +91,11 @@ export default function InsightsWorkoutDetailPage({
       ) : (
         <>
           <WorkoutDetailHeader workout={data} />
-          {/* Reserved Activity-Insight seam — `aiInsight` is always null
-              today, so this renders nothing. When the Phase-2 job
-              populates it, the card mounts here with zero layout rework. */}
+          {/* The Activity Insight, above the stats it describes. `null` is the
+              common case and renders nothing — the paragraph is written by a
+              background job when the workout lands, so a historical or
+              re-synced workout has none and opening this page never asks for
+              one. */}
           {data.aiInsight ? (
             <WorkoutInsightCard insight={data.aiInsight} />
           ) : null}