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
Clarify First
Before synthesizing the review, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
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.
1---
2name: weekly-review
3description: >
4 Synthesize a week of inputs (calendar, tasks, journal, OKR check-ins) into
5 a structured review with wins, learnings, blockers, and next-week priorities.
6 Use for a Friday/Sunday weekly review, GTD review, or OKR check-in.
7license: MIT + Commons Clause
8metadata:
9 version: 1.0.0
10 author: borghei
11 category: personal-productivity
12 domain: personal-effectiveness
13 updated: 2026-05-04
14 python-tools: weekly_review_synthesizer.py
15 tech-stack: GTD, OKRs, productivity
16---
17
18# Weekly Review
19
20Synthesize a week into a structured review covering wins, learnings, blockers, and next-week priorities.
21
22---
23
24## Keywords
25
26weekly review, GTD, getting things done, OKR check-in, retrospective, weekly retro, journal, reflection, end of week, EOW
27
28---
29
30## Clarify First
31
32Before synthesizing the review, confirm these inputs. If any is unknown or vague, ASK — do not assume:
33
34- [ ] **The week's raw inputs** — actual wins, learnings, and blockers; this is the content the review synthesizes, not invented
35- [ ] **OKR / goal progress** — current numbers vs target drives the check-in section and flags drift
36- [ ] **Next-week priorities** — the top 1-3 commitments the review must end on
37
38Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
39
40---
41
42## Quick Start
43
441. Fill in `assets/weekly_review_input.json` with the past week's wins, learnings, blockers, OKR progress
452. Run: `python scripts/weekly_review_synthesizer.py weekly_review_input.json`
463. Save the output as your week's review
47
48---
49
50## Core Workflows
51
52### Workflow 1: Standard Friday Review (30 min)
531. Capture 3-5 wins from the past week
542. Capture 1-3 learnings (what surprised you, what you got wrong)
553. Capture top 1-3 blockers / risks for next week
564. Update OKR / goal progress
575. List top 3 priorities for next week
586. Run synthesizer
59
60**Time Estimate:** 30-45 minutes weekly.
61
62### Workflow 2: Bootstrap (First Time)
631. Read `references/weekly_review_methodology.md`
642. Decide cadence (Friday afternoon vs Sunday evening — both work)
653. Block 30-45 min recurring on calendar
664. Use input template; tune over 4 weeks until format works for you
67
68**Time Estimate:** 1 hour to set up; 30-45 min weekly thereafter.
69
70### Workflow 3: Quarterly Pattern Review
711. Save weekly reviews in a single folder
722. Quarterly: read all 12-13 weeks
733. Look for patterns: recurring blockers, energy patterns, OKR drift
744. Adjust cadence, cadence, or commitments based on patterns
75
76**Time Estimate:** 1-2 hours quarterly.
77
78---
79
80## Tools
81
82### weekly_review_synthesizer.py
83
84Reads structured weekly input JSON and produces a markdown weekly review.
85
86```bash
87python scripts/weekly_review_synthesizer.py input.json
88python scripts/weekly_review_synthesizer.py input.json --json
89```
90
91---
92
93## Reference Guides
94
95- **`references/weekly_review_methodology.md`** — GTD weekly review, OKR check-in patterns, common pitfalls
96
97---
98
99## Templates
100
101- **`assets/weekly_review_input.json`** — Input template
102
103---
104
105## Best Practices
106
107- **Block the time.** 30 min recurring; defend against rescheduling.
108- **Same time each week.** Habits stick when the trigger is consistent.
109- **Capture the pattern, not the noise.** Weekly review is a layer above the moment-to-moment task list.
110- **OKR check-in over chase.** Weekly OKR progress is signal; quarterly is the action moment.
111- **Compound across weeks.** Reviews are most useful when read in batches.
112- **Don't over-format.** A messy review you actually do beats a perfect one you skip.