---
name: weekly-review-draft
description: |
  Draft a weekly review: what shipped, what slipped, what's next. Pulls
  from Linear cycle data, GitHub merged-PR list (last 7 days), Notion
  weekly-notes page if one exists, calendar meeting attendance, and
  Wovol ops incidents. Saves to audit/digests/weekly-{ISO_WEEK}.md and
  Gmail draft.
profile: wovol
permission_tier: L0
side_effects:
  - gmail_create_draft
  - writes_to: audit/digests/weekly-{ISO_WEEK}.md
location_in_repo: .claude/skills/prep/weekly-review-draft/
---

# weekly-review-draft

## When to invoke
- Manual: Friday afternoon or Sunday evening, `/weekly-review-draft`
- Recommended schedule: weekly cycle review aligned with Linear cycle close

## Profile check
```bash
python3 "$WOVOL_LAB_ROOT/.claude/skills/_foundation/profile-manager/scripts/profile.py" verify wovol || exit 2
```

## Pipeline

1. **Linear cycle data** — for the most recently closed cycle (or current
   cycle if mid-week): completed issues, carried-over issues, cycle health.

2. **GitHub** — PRs merged in last 7 days (by user + by team), commits to
   main on watched repos.

3. **Notion** — if a "Weekly Review YYYY-WXX" page exists, pull
   prior-version notes (template). If not, create the body as the new
   page draft.

4. **Calendar** — meetings attended / declined / no-show in last 7 days,
   meetings booked for next 7 days.

5. **Ops** — incidents from wovol-ops-pulse JSONs across the week,
   summarized.

6. **Render** Markdown:
   ```markdown
   # Weekly Review — YYYY-WXX (M/D – M/D)

   ## What shipped
   - <repo-A>: merged N PRs (M features, K fixes)
   - <repo-B>: shipped v<X.Y.Z>
   - <repo-C>: <milestone reached>

   ## What slipped
   - <ISSUE-KEY> (planned by Wed; PR open since Tue, waiting on <Person>)
   - GitHub Actions failures: <N> (<workflow names>)

   ## What I learned
   - (3 bullets — fill these in manually)

   ## Next week
   - Top 3 priorities from current Linear cycle
   - 1 thing to say no to

   ## Energy / focus check
   - (1-2 lines — fill in manually)
   ```

7. **Save**: `audit/digests/weekly-{ISO_WEEK}.md` + Gmail draft (label `wovol-lab/weekly-review`)

## What this skill does NOT do
- Publish to Notion automatically (user reviews + publishes from the draft)
- Close cycles in Linear
- Comment on Linear/GitHub