weekly-review

name: weekly-review
description: Weekly review and planning session. Use at end of week or weekend to review progress, plan next week, and set priorities. Triggers on "weekly review", "plan my week", "what did I do this week", "Sunday planning".
model: claude-opus-4-5-20251101
allowed-tools: Read, Write, Edit, Glob, Bash(gh:, date:)

Run a weekly review and planning session. Keep it conversational - one section at a time.

Step 0: Get Week Info

date +%Y-%m-%d        # Today
date +%Y-W%V          # Current ISO week
date -d "last sunday" +%Y-%m-%d  # Week start (for lookback)

Step 1: Weekly Note Setup

1. Check if this week's note exists: my-vault/02 Calendar/YYYY-Www.md
2. If not, create from 09 System/Templates/Weekly Template.md
3. Replace Templater placeholders with actual dates
4. The week note format is YYYY-[W]ww (e.g., 2026-W03)

Step 2: Journal Completeness Check

Critical: Verify all 7 days have journal entries and content.

# List last 7 days' journal files
for i in {0..6}; do
  d=$(date -d "$i days ago" +%Y-%m-%d)
  f="my-vault/02 Calendar/$d.md"
  if [[ -f "$f" ]]; then
    lines=$(wc -l < "$f")
    echo "$d: EXISTS ($lines lines)"
  else
    echo "$d: MISSING"
  fi
done

For each existing entry, check if sections are filled in:
- "# What Did I Do?" - should have content
- "# What Did I Work On?" - should have content
- "# What Did I Study?" - optional but note if empty

Report gaps: "These days are missing entries: ..." or "These entries look empty: ..."
Offer to fill in: "Want me to check GitHub for commits on those days to help fill them in?"

Step 3: Review the Week

GitHub Activity (all week)

gh search commits --author=TaylorHuston --committer-date=YYYY-MM-DD..YYYY-MM-DD --limit=50

Summarize by project/repo.

Journal Highlights

Read each day's journal and extract:
- Personal: From "What Did I Do?"
- Technical: From "What Did I Work On?"
- Learning: From "What Did I Study?"

Present as a brief week summary, not raw dump.

Learning Progress

1. Check .claude/learning-sessions/learning-plan.json if exists
2. Note topics covered, sessions completed

Project Progress

1. Scan ideas/*/issues/ for any WORKLOG.md updates this week
2. Note completed tasks, status changes

Step 4: Fill In Weekly Note

Update the weekly note (my-vault/02 Calendar/YYYY-Www.md) sections:
- What Went Well: Ask Taylor
- What Didn't Go Well: Ask Taylor
- Key Accomplishments: Summarize from review
- Lessons Learned: Ask Taylor

Step 5: Plan Next Week

Ask Taylor (one at a time):
1. "Any interviews or job search priorities this week?"
2. "What's the one thing that would make next week a success?"
3. "Any personal commitments to work around?"

Fill in "Next Week's Focus" section with their answers.

Step 6: Memory Capture

Review conversation for memory-worthy items:
- Job search updates
- New preferences or workflow changes
- Project decisions
- Personal context changes

Update .claude/memories/about-taylor.md if job status or major context changed.

Conversational Flow

Don't dump everything at once. Flow should be:
1. "Let me check your journal entries for this week..." → Report gaps
2. "Here's what I found from your week..." → Brief summary
3. "What went well this week?" → Capture response
4. "What didn't go well?" → Capture response
5. "Any lessons learned?" → Capture response
6. "Looking ahead - any job search priorities?" → Plan next week
7. "What would make next week a success?" → Set focus
8. "I've updated your weekly note. Anything else?"