weekly-review

name	weekly-review
description	Weekly summary with trends, patterns, and recommendations. Triggers on "weekly review", "week summary", "what happened this week", "summarize the week", or similar requests.

Weekly Review

Weekly synthesis from daily logs, experiments, and cross-domain patterns.

Workflow

digraph weekly {
  "Determine week" -> "Load daily logs";
  "Load daily logs" -> "Scan referenced files";
  "Scan referenced files" -> "Load experiments + previous review";
  "Load experiments + previous review" -> "Aggregate & analyze";
  "Aggregate & analyze" -> "Write review";
  "Write review" -> "Save";
}

1. Determine Week

• If user specified a week → use that
• If not → current week (Monday to Sunday)
• Week number: ISO 8601 (YYYY-WXX)

2. Load Daily Logs

Load ALL daily logs for the week:

logs/daily/YYYY-MM/YYYY-MM-DD.md (for each day)

Note which days are missing data.

3. Scan Referenced Files

For EACH daily log, check if it references:

• Experiment files (experiments/EXP-*)
• Research files (docs/research/...)
• Domain READMEs
• Medical records

If a log references a file → load it for context.

4. Load Additional Context

File	Why
Previous weekly review (logs/weekly/YYYY-WXX.md)	Compare vs last week
Active experiments (experiments/EXP-*)	Progress tracking
docs/context/watchlist.md	Check if any triggers were met

5. Aggregate & Analyze

Metrics (averages + trends):

Dynamically determine which metrics to aggregate from the daily logs — use whatever the user tracks. Build a table with: Metric, Average, Min, Max, Trend vs previous week.

Activity:

• Workouts (type, frequency, intensity)
• Total steps, calories (if tracked)
• Rest days

Experiments:

• Progress for each active experiment
• Observations, metrics, compliance

Patterns & Correlations:

• Best/worst day and why
• Correlations (sleep vs mood, exercise vs HRV, etc.)
• Anomalies (anything "off"?)
• Comparison to previous week

Observations:

• What changed
• What worked / didn't work
• New insights

6. Write & Save

Save as: logs/weekly/YYYY-WXX.md

Must contain:

1. Date range
2. Metrics table (adapted to user's tracked metrics)
3. Activity summary
4. Experiment progress (if active)
5. Patterns & correlations
6. Comparison vs previous week
7. Recommendations for next week

At the end, ALWAYS ask the user:

• Anything missing? Want to add something?
• Do you agree with the observations?

If user provided an argument

/weekly-review W04 → review for week 4 /weekly-review → current week