week-review

Installation
SKILL.md

Purpose

Create a synthesis of the week reviewing activity, progress, and what was accomplished. Uses concrete metrics, not vague percentages.


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 Reviews

  • 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:

  1. Ship pricing page — Complete (pushed to prod Wednesday)
    • Deliverable: New pricing page live at /pricing
    • Tasks completed: 5 of 5
  2. 🔄 Write Q1 strategy doc — 60% complete
    • Done: Outline, competitive analysis, recommendations
    • Remaining: Executive summary, financial projections
    • 2 tasks left
  3. 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:

  1. 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.
  2. 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.

  3. 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 (NEW)

If daily reviews exist, 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:

  1. Slack - 5 items
  2. Email - 4 items
  3. Notion - 3 items

People who asked most of you:

  1. Sarah Chen - 4 asks
  2. 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:

  1. Call list_ideas(status="active", min_score=70) from Improvements MCP
  2. Pick the top 3 ideas by score that haven't been surfaced in the last week review
  3. 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:

  1. Update Tasks.md with new priorities
  2. Archive completed items
  3. Update project pages with status changes
  4. 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".
Related skills
Installs
1
Repository
davekilleen/dex
GitHub Stars
340
First Seen
Mar 30, 2026