| name | weekly-review |
| description | Synthesize a week of inputs (calendar, tasks, journal, OKR check-ins) into a structured weekly review with wins, learnings, blockers, and next-week priorities. Use every Friday or Sunday, or when the user mentions weekly review, GTD review, OKR check-in, or end-of-week reflection.
|
| license | MIT + Commons Clause |
| metadata | {"version":"1.0.0","author":"borghei","category":"personal-productivity","domain":"personal-effectiveness","updated":"2026-05-04T00:00:00.000Z","python-tools":"weekly_review_synthesizer.py","tech-stack":"GTD, OKRs, productivity"} |
Weekly Review
Synthesize a week into a structured review covering wins, learnings, blockers, and next-week priorities.
Keywords
weekly review, GTD, getting things done, OKR check-in, retrospective, weekly retro, journal, reflection, end of week, EOW
Quick Start
- Fill in
assets/weekly_review_input.json with the past week's wins, learnings, blockers, OKR progress
- Run:
python scripts/weekly_review_synthesizer.py weekly_review_input.json
- Save the output as your week's review
Core Workflows
Workflow 1: Standard Friday Review (30 min)
- Capture 3-5 wins from the past week
- Capture 1-3 learnings (what surprised you, what you got wrong)
- Capture top 1-3 blockers / risks for next week
- Update OKR / goal progress
- List top 3 priorities for next week
- Run synthesizer
Time Estimate: 30-45 minutes weekly.
Workflow 2: Bootstrap (First Time)
- Read
references/weekly_review_methodology.md
- Decide cadence (Friday afternoon vs Sunday evening — both work)
- Block 30-45 min recurring on calendar
- Use input template; tune over 4 weeks until format works for you
Time Estimate: 1 hour to set up; 30-45 min weekly thereafter.
Workflow 3: Quarterly Pattern Review
- Save weekly reviews in a single folder
- Quarterly: read all 12-13 weeks
- Look for patterns: recurring blockers, energy patterns, OKR drift
- Adjust cadence, cadence, or commitments based on patterns
Time Estimate: 1-2 hours quarterly.
Tools
weekly_review_synthesizer.py
Reads structured weekly input JSON and produces a markdown weekly review.
python scripts/weekly_review_synthesizer.py input.json
python scripts/weekly_review_synthesizer.py input.json --json
Reference Guides
references/weekly_review_methodology.md — GTD weekly review, OKR check-in patterns, common pitfalls
Templates
assets/weekly_review_input.json — Input template
Best Practices
- Block the time. 30 min recurring; defend against rescheduling.
- Same time each week. Habits stick when the trigger is consistent.
- Capture the pattern, not the noise. Weekly review is a layer above the moment-to-moment task list.
- OKR check-in over chase. Weekly OKR progress is signal; quarterly is the action moment.
- Compound across weeks. Reviews are most useful when read in batches.
- Don't over-format. A messy review you actually do beats a perfect one you skip.
