| name | week-review |
| description | Review week's progress with concrete accomplishments (not fake percentages), pattern detection, and goal tracking. |
| context | fork |
Purpose
Create a synthesis of the week reviewing activity, progress, and what was accomplished. Uses concrete metrics, not vague percentages.
Step 0: Process Unprocessed Meetings
Before gathering data, ensure all meetings from this week are in the vault by running /process-meetings. This pulls any unprocessed meetings from the meeting source (Otter.ai, Granola, etc.), creates meeting notes, updates person/company pages, and extracts tasks — so the weekly synthesis has complete data.
- If no new meetings are found, continue silently
- If meetings are processed, note the count for the synthesis
- Do NOT ask for a skill rating after this sub-step — save that for the end of the full review
Step 0.5: Dex Inbox Check (Phone Captures)
After processing meetings, check for tasks captured from phone that haven't been triaged:
Use: reminders_list_items(list_name="Dex Inbox")
If items found:
- Surface them: "📱 Phone captures not yet triaged (X items in Dex Inbox)"
- Run triage flow: infer pillar, confirm with user, create task, mark Reminder complete
- If user wants to defer: leave in Dex Inbox
If empty: Skip silently.
Data Sources
1. Task Progress
03-Tasks/Tasks.md — Task completion status
02-Week_Priorities/Week_Priorities.md — Weekly priorities
2. Project Activity
04-Projects/**/*.md — Modified this week
3. Meetings & People
00-Inbox/Meetings/*.md — Meeting notes from this week
People/**/*.md — Person pages updated
4. Learnings
06-Resources/Learnings/**/*.md — Explicit learnings
System/Session_Learnings/*.md — Auto-captured session learnings
5. Daily Plans & Reviews
07-Archives/Plans/YYYY-MM-DD.md — This week's daily plans (primary record of planning ritual)
07-Archives/Reviews/Daily_Review_YYYY-MM-DD.md — This week's reviews
6. Journals (If Enabled)
00-Inbox/Journals/YYYY/MM-Month/ — Morning/evening journals
Analysis Process
1. Weekly Priority Completion (Concrete, Not Percentages)
Don't say: "Goal X went from 40% to 55%"
Do say: "You completed 2 of 3 weekly priorities"
Use: get_week_progress()
For each weekly priority:
- Complete: ✅ What was the deliverable? When did you finish?
- In Progress: 🔄 What specifically got done? What's left?
- Not Started: ❌ Why? Should it carry forward?
Surface concrete accomplishments:
"This week's priorities:
- ✅ Ship pricing page — Complete (pushed to prod Wednesday)
- Deliverable: New pricing page live at /pricing
- Tasks completed: 5 of 5
- 🔄 Write Q1 strategy doc — 60% complete
- Done: Outline, competitive analysis, recommendations
- Remaining: Executive summary, financial projections
- 2 tasks left
- ❌ Customer interviews — Not started
- Reason: Calendar was too stacked
- Recommendation: Carry to next week with protected time"
1.5 Semantic Goal-to-Work Mapping (if QMD available)
Check if semantic search is available by looking for qmd in PATH.
If available, enhance the weekly priority review with meaning-based analysis:
-
Auto-detect goal contributions: For each completed task this week, search:
qmd query "task title/description" --limit 3
against quarterly goals. Catch tasks that advanced goals without explicit links.
- Example: "Built customer health dashboard" semantically matches goal "Improve NPS tracking" — different words, same work.
-
Cross-priority connections: Search for work that bridges multiple priorities:
qmd query "priority 1 description" --limit 5
Surface tasks that contributed to more than one priority.
-
Thematic patterns: Search for recurring themes across the week's work:
qmd query "common theme from meetings/tasks" --limit 5
Detect patterns like "most of your work this week clustered around customer retention" even when tasks used different terminology.
Integration: Merge findings into the Quarterly Goals table — add a "Hidden contributions" row for semantically-detected but not explicitly-linked work. Only show genuinely new connections, not things already captured by keyword matching.
If QMD unavailable: Skip silently. Task completion stats still work fine.
2. Task Completion Stats (Concrete Numbers)
Scan 03-Tasks/Tasks.md for completion timestamps from this week:
- Count tasks completed (look for
✅ YYYY-MM-DD in date range)
- Count tasks added mid-week
- Count tasks carried over
Surface:
"Tasks this week:
- Completed: 14 tasks
- Added mid-week: 6 tasks (scope creep?)
- Carried over: 3 tasks
Completion rate: 82% (14 of 17 planned)"
3. Quarterly Goals Progress (Concrete Milestones)
Don't use fake percentages. Use milestone counts and specific accomplishments.
Use: get_quarterly_goals()
Use: get_goal_status(goal_id) for each goal
For each goal:
- Milestones completed this week
- Total milestones done vs. total
- Weeks since last milestone
- Specific accomplishments that moved the goal
"Quarterly Goals Progress:
| Goal | Milestones | This Week | Status |
|---|
| Launch v2.0 | 3 of 5 | +1 (Pricing page shipped) | On track |
| Improve NPS | 1 of 4 | No change | ⚠️ Stalled (3 weeks) |
| Team Capacity | 2 of 3 | No change | On track |
Goal 1 advanced because you completed Priority 1.
Goal 2 needs attention — no linked work completed this week."
4. Daily Completion Rate Trend
First check 07-Archives/Plans/ for this week's daily plans. Count how many days had a /daily-plan generated. If daily reviews also exist, cross-reference plan focus items against review completion. If only plans exist (no corresponding review), still count the plan as evidence of the planning ritual and note which focus items were checked off in the plan file itself.
Calculate completion trends:
"Daily plan completion this week:
| Day | Planned | Done | Rate |
|---|
| Mon | 3 | 2 | 67% |
| Tue | 3 | 3 | 100% |
| Wed | 3 | 2 | 67% |
| Thu | 3 | 1 | 33% |
| Fri | 3 | 2 | 67% |
Week average: 67%
Pattern: Thursday was rough (too many meetings?)"
5. Meeting Analysis
Review meeting notes from the week:
- Meetings held
- Key decisions
- Action items created
- Follow-ups that might have slipped
5.5 Commitment Health Analysis (NEW)
If ScreenPipe and Commitment Detection are available, show aggregate stats:
Use: get_commitment_stats(
start_date="YYYY-MM-DD", # Monday of this week
end_date="YYYY-MM-DD" # Today
)
Surface to user:
"📊 Commitment Health This Week
Detected across apps: 12 potential commitments
Already had tasks: 7 (58%)
Created from prompts: 3
Dismissed as handled: 2
Apps with most uncaptured asks:
- Slack - 5 items
- Email - 4 items
- Notion - 3 items
People who asked most of you:
- Sarah Chen - 4 asks
- Product team - 3 asks
💡 Consider: Check Slack more frequently for asks, or run /commitment-scan mid-week"
If no commitment data:
Skip this section silently (user may not have ScreenPipe or commitment detection enabled).
5.8 Email Communication Stats (if Gmail connected)
Check System/integrations/config.yaml for google-workspace.enabled: true.
If enabled and Google Workspace MCP is healthy:
- Emails sent this week — count of sent messages in the review period
- Average response time — how quickly you replied to incoming emails
- Threads still open — conversations with no resolution (back-and-forth still active)
- Follow-up detection — emails waiting > 48h for a reply from you or from others
Surface in the review:
"Email this week:
| Metric | Value |
|---|
| Emails sent | 47 |
| Avg response time | 3.2 hours |
| Open threads | 12 |
| Awaiting your reply (> 48h) | 3 |
Observation: You have 3 emails waiting for replies longer than 48 hours. Consider clearing those early next week."
If unhealthy or not enabled: skip this section silently.
6. Learning Compilation & Pattern Detection
Review System/Session_Learnings/ files from this week:
Pattern Detection:
- Recurring issues: Same mistake 2+ times? Suggest adding to Mistake_Patterns.md
- Consistent preferences: User repeatedly mentioned a workflow preference?
"This week's session learnings revealed:
Recurring Issues:
- Calendar overload (mentioned 3 times) — Consider blocking focus time
Workflow Preferences:
- Prefer morning for deep work (mentioned 2 times)
Should I add these to your pattern files?"
Output Format
Create 00-Inbox/Weekly_Synthesis_YYYY-MM-DD.md:
# Weekly Synthesis — Week of [Date]
## TL;DR
- **Weekly priorities:** [X] of 3 complete
- **Tasks:** [X] completed / [Y] planned — [Z]% completion
- **Meetings:** [N] total
- **Key wins:** [1-2 bullets]
- **Carried over:** [1-2 items]
---
## 🎯 Weekly Priorities
### 1. [Priority 1] — ✅ Complete
**Deliverable:** [What was shipped/finished]
**Completed:** [Day]
**Tasks:** 5 of 5
### 2. [Priority 2] — 🔄 In Progress (60%)
**Done this week:**
- [Specific accomplishment]
- [Specific accomplishment]
**Remaining:**
- [Specific task]
- [Specific task]
### 3. [Priority 3] — ❌ Not Started
**Why:** [Reason]
**Recommendation:** [Carry forward / Deprioritize / Defer]
---
## 📊 Task Completion
| Metric | Count |
|--------|-------|
| Tasks completed | 14 |
| Tasks added mid-week | 6 |
| Tasks carried over | 3 |
| **Completion rate** | **82%** |
**Observation:** [Any patterns — e.g., lots of scope creep]
---
## 🎯 Quarterly Goals
| Goal | Milestones | This Week | Status |
|------|------------|-----------|--------|
| [Goal 1] | X of Y | +Z | [Status] |
| [Goal 2] | X of Y | — | [Status] |
| [Goal 3] | X of Y | +Z | [Status] |
**Goals advancing:** [Which ones moved]
**Goals stalled:** [Which ones need attention]
---
## 📊 Daily Completion Trend
| Day | Planned | Done | Rate |
|-----|---------|------|------|
| Mon | 3 | 2 | 67% |
| Tue | 3 | 3 | 100% |
| Wed | 3 | 2 | 67% |
| Thu | 3 | 1 | 33% |
| Fri | 3 | 2 | 67% |
**Week average:** [X]%
**Observation:** [Pattern noticed]
---
## 📅 Meetings & People
### Meetings Held
| Date | Topic | Key Outcome |
|------|-------|-------------|
| [Day] | [Topic] | [Decision/insight] |
### New Contacts
- [Name] at [Company] — [context]
### Action Items from Meetings
- [ ] [Action] — for [who] — due [when]
---
## 💡 Learnings
### Session Learnings (Auto-Captured)
- [Learning 1]
- [Learning 2]
### Patterns Identified
- **Recurring issue:** [Issue] (appeared X times)
- **Preference noted:** [Preference]
### Actionable Improvements
- [ ] [Specific improvement to make]
---
## 📊 Pillar Balance
| Pillar | Tasks Done | Focus |
|--------|------------|-------|
| [Pillar 1] | X tasks | Heavy |
| [Pillar 2] | X tasks | Light |
| [Pillar 3] | X tasks | None |
**Observation:** [Balance assessment]
---
## ➡️ Next Week
### Suggested Priorities
Based on this week's progress:
1. **[Priority]** — [Why: carries over / goal needs attention / commitment]
2. **[Priority]** — [Why]
3. **[Priority]** — [Why]
### Blocked Items Needing Resolution
| Item | Blocked Since | What Would Unblock It |
|------|---------------|-----------------------|
| [Item] | [Date] | [Action needed] |
---
## 🏆 Career Evidence (If Career System Enabled)
**Significant accomplishments worth capturing:**
- [Accomplishment] — demonstrates [skill]
- [Accomplishment] — shows [impact]
> "Want to save any of these as career evidence?"
---
*Generated: [timestamp]*
*Weekly completion: X of 3 priorities*
*Task completion: X%*
Innovation Concierge: Top 3 This Week
At the end of the weekly review, surface the top backlog ideas:
- Call
list_ideas(status="active", min_score=70) from Improvements MCP
- Pick the top 3 ideas by score that haven't been surfaced in the last week review
- Include in the output format as a section:
## 🤖 Top 3 Dex Improvement Ideas
Your AI-curated backlog has surfaced these high-impact ideas:
1. **[idea-XXX]** Title (Score: XX)
Why now: [Brief evidence or timeliness reason]
2. **[idea-XXX]** Title (Score: XX)
Why now: [Brief evidence]
3. **[idea-XXX]** Title (Score: XX)
Why now: [Brief evidence]
> Interested? Run `/dex-improve [idea-id]` to workshop any of these.
> Run `/dex-backlog` to see the full ranked backlog.
Rules:
- Only show ideas with score >= 70 (don't surface low-value noise)
- Prefer ideas with recent "Why Now?" evidence
- If fewer than 3 qualifying ideas, show however many exist
- If no qualifying ideas, skip this section entirely
- This is a gentle nudge, not a sales pitch
Skill Quality Insights
After generating the synthesis, call get_skill_ratings() from Work MCP (no filter — get all skills).
If ratings exist for any skills:
Add a section to the review:
## Skill Quality This Week
| Skill | Avg Rating | Trend | Note |
|-------|-----------|-------|------|
| [skill] | [avg]/5 | [improving/stable/declining] | [most recent note] |
Only surface skills that are declining or below 3.0. If everything is stable/good, skip this section entirely. One line for healthy, only details for problems.
Then: Run /identity-snapshot to update System/identity-model.md with fresh data from this week.
Follow-up Actions
After synthesis:
- Update Tasks.md with new priorities
- Archive completed items
- Update project pages with status changes
- Offer to run
/week-plan for next week
MCP Dependencies
| Integration | MCP Server | Tools Used |
|---|
| Work | dex-work-mcp | list_tasks, get_week_progress, get_quarterly_goals, get_goal_status |
| Calendar | dex-calendar-mcp | calendar_get_events_with_attendees |
| Improvements | dex-improvements-mcp | list_ideas |
| Analytics | dex-analytics | track_event |
Track Usage (Silent)
Update System/usage_log.md to mark weekly review as used.
Analytics (Silent):
Call track_event with event_name week_review_completed and properties:
priorities_completed: number of priorities completed
priorities_total: total number of priorities
tasks_completed: number of tasks completed this weekThis only fires if the user has opted into analytics. No action needed if it returns "analytics_disabled".