DavidROliverBA/.claude/skills/weekly-summary

/weekly-summary

Generate comprehensive weekly summary from daily notes, meetings, tasks, and project updates using parallel sub-agents.

Usage

/weekly-summary
/weekly-summary --last-week
/weekly-summary --from 2026-01-01 --to 2026-01-07
/weekly-summary --output page    # Create Page note instead of just outputting

Instructions

This skill uses 5 parallel sub-agents to gather data concurrently from different vault areas, then synthesizes a comprehensive weekly report.

Phase 1: Launch Parallel Data Collectors

Create 5 Task agents running in parallel (use model: "haiku" for speed):

Agent 1: Daily Notes Collector (Haiku)

Task: Extract key activities from daily notes
- Determine date range (default: last 7 days, or from user's --from/--to flags)
- Use Glob to find +Daily/YYYY/YYYY-MM-DD.md files in range
- For each daily note:
  - Read content
  - Extract "Wins" or achievements section
  - Extract "Challenges" or blockers section
  - Extract "Notes" or key decisions
  - Extract task completions (lines with [x])
  - Note significant activities or meetings mentioned
- Return: Structured data with date, wins, challenges, decisions, completed tasks

Agent 2: Tasks Analyzer (Haiku)

Task: Analyze task completions and changes
- Use Glob to find all "Task - *.md" files
- Filter to tasks modified in date range (check frontmatter.modified)
- Categorize:
  - Completed this week (completed: true, modified in range)
  - New tasks created (created in range)
  - Still in progress (high priority, not completed)
  - Blocked tasks (status issues mentioned)
- For each category, extract: title, priority, project, due date
- Return: Task statistics and key task movements

Agent 3: Meetings Collector (Haiku)

Task: Gather meeting summaries from this week
- Use Glob to find all "+Meetings/Meeting - *.md" files
- Filter to meetings with date in range (frontmatter.date)
- For each meeting:
  - Extract title, date, attendees, project
  - Extract summary or key decisions from frontmatter or first section
  - Note action items (lines starting with "- [ ]" or "TODO")
  - Extract important discussion points
- Group by project if possible
- Return: Chronological list of meetings with key points

Agent 4: ADR Tracker (Haiku)

Task: Track architecture decisions this week
- Use Glob to find all "ADR - *.md" files
- Filter to ADRs modified or created in date range
- For each ADR:
  - Extract title, status (proposed/accepted/deprecated)
  - Note status changes (proposed → accepted)
  - Extract decision and rationale summary
  - Note impacted projects or systems
- Return: New ADRs, status changes, key decisions

Agent 5: Project Progress Tracker (Haiku)

Task: Analyze project progress this week
- Use Glob to find all "Project - *.md" files
- Filter to projects with status: active
- For each active project:
  - Check if modified in date range
  - Extract status, priority, recent updates
  - Count related tasks completed this week
  - Note any status changes (paused, completed)
  - Extract milestones mentioned
- Return: Project progress summary with task completions

Phase 2: Wait for All Agents

Use TaskOutput with blocking to wait for all 5 agents to complete. Collect their outputs.

Phase 3: Synthesize Weekly Summary

Combine all agent data into cohesive weekly summary:

# Weekly Summary: {{Start Date}} - {{End Date}}

Generated: {{TIMESTAMP}}

## 📊 Week at a Glance

**Highlights:**
- {{Top 3 achievements from daily notes}}
- {{Major decisions or milestones}}
- {{Significant meetings or collaborations}}

**Statistics:**
- **Tasks Completed:** {{count}} ({{high priority count}} high priority)
- **New Tasks Created:** {{count}}
- **Meetings:** {{count}} ({{total hours if available}})
- **ADRs:** {{new count}} new, {{status change count}} updated
- **Active Projects:** {{count}} ({{tasks completed across projects}})

---

## ✅ Completed Tasks ({{count}})

### High Priority ({{count}})
- [x] [[Task - {{title}}]] ({{project}}) - {{due date}}
- [x] [[Task - {{title}}]] ({{project}})

### Medium Priority ({{count}})
{{list}}

### Low Priority ({{count}})
{{list if > 5, else "All completed"}}

---

## 🚀 Project Progress

### [[Project Name]] ({{status}})
**Tasks Completed:** {{count}}/{{total}}
**Key Updates:**
- {{update from project note or meetings}}
- {{completed task summaries}}

**Next Steps:**
- {{open high priority tasks}}
- {{upcoming milestones}}

---

### [[Another Project]] ({{status}})
{{same format}}

---

## 🏛️ Architecture Decisions

### New ADRs ({{count}})
- **[[ADR - {{title}}]]** ({{status}})
  - **Decision:** {{one-line summary}}
  - **Rationale:** {{brief reason}}
  - **Impact:** {{projects or systems affected}}

### Status Changes ({{count}})
- **[[ADR - {{title}}]]**: Proposed → Accepted
  - {{context for change}}

---

## 📅 Meetings This Week ({{count}})

### Monday, {{DATE}}
- **[[Meeting - {{title}}]]** ({{project}})
  - Attendees: {{list}}
  - **Key Points:** {{summary}}
  - **Action Items:** {{count}} ({{assigned tasks}})

### Wednesday, {{DATE}}
{{same format}}

---

## 💡 Daily Highlights

### {{Monday DATE}}
**Wins:**
- {{from daily note}}

**Challenges:**
- {{from daily note}}

### {{Tuesday DATE}}
{{same format}}

---

## 🎯 Focus for Next Week

**Priorities:**
1. {{High priority open tasks}}
2. {{Upcoming project milestones}}
3. {{Pending ADR decisions}}
4. {{Follow-ups from meetings}}

**Blocked Items:**
- {{Tasks or projects marked blocked}}
- {{Challenges noted in daily notes}}

**Upcoming:**
- {{Due dates next week}}
- {{Scheduled meetings}}
- {{Project deadlines}}

---

## 📈 Trends & Insights

**Productivity:**
- Task completion rate: {{completed}}/{{total new + existing}} ({{%}})
- Average daily task completions: {{avg}}
- Most active project: [[{{project}}]] ({{task count}} tasks)

**Collaboration:**
- People most frequently mentioned: {{top 3}}
- Cross-project connections: {{count meetings involving 2+ projects}}

**Quality:**
- ADRs with quality indicators: {{count}}/{{total}} ({{%}})
- Stale projects updated: {{count}}
- Documentation created: {{new Page notes}}

---

## 🏷️ Tags This Week

Most frequently used tags:
- #{{tag1}} ({{count}} notes)
- #{{tag2}} ({{count}} notes)
- #{{tag3}} ({{count}} notes)

---

## Related Notes

- [[Weekly Summary {{previous week}}]] (last week)
- Active projects: {{list wiki-links}}
- Team members involved: {{list Person wiki-links}}

Phase 4: Output Options

Based on user's --output flag:

1. Console Output (default)

   • Print the summary to console
   • Offer to save as Page note

2. Create Page Note

   • Save as Page - Weekly Summary YYYY-MM-DD.md
   • Frontmatter:

     type: Page
     title: Weekly Summary {{START_DATE}} - {{END_DATE}}
     created: {{TODAY}}
     tags:
       - weekly-summary
       - productivity
       - meta/reporting
     date-range:
       start: {{START_DATE}}
       end: {{END_DATE}}
     

3. Append to Weekly Log

   • Check if Page - 2026 Weekly Summaries.md exists
   • Append this week's summary
   • Add to table of contents

Phase 5: Follow-up Prompts

After generating summary, offer:

✅ Weekly summary generated!

Would you like to:
1. Export to Page note for archiving
2. Review blocked tasks and challenges
3. Generate next week's priorities as Task notes
4. Create meeting follow-up tasks
5. Update project notes with progress

Use Cases

Weekly Reviews:

• Personal productivity tracking
• Team status reports
• Manager updates
• Sprint retrospectives

Time Tracking:

• Where did time go this week?
• Which projects got attention?
• Meeting time vs. execution time

Accountability:

• Track commitment completions
• Identify recurring blockers
• Measure velocity trends

Historical Record:

• Archive weekly progress
• Year-end reviews
• Performance self-assessments

Configuration

Date Range Detection

// Default: Last 7 days
if (args.includes('--last-week')) {
  // Previous Monday - Sunday
  start = previousMonday;
  end = previousSunday;
} else if (args.includes('--from') && args.includes('--to')) {
  // Custom range
  start = parseDate(args['--from']);
  end = parseDate(args['--to']);
} else {
  // Last 7 days from today
  start = today - 7;
  end = today;
}

Customization

Users can customize by editing .claude/skills/weekly-summary/SKILL.md:

• Adjust date range defaults
• Add/remove sections
• Change prioritization logic
• Modify output format
• Add custom metrics

Performance

• 5 parallel agents = 5x faster than sequential
• ~100 notes/week: 20-40 seconds
• ~500 notes/week: 1-2 minutes
• Uses Haiku for speed (Sonnet alternative for deeper analysis)

Notes

• Excludes templates and system notes
• Handles missing data gracefully (some weeks may have no ADRs, etc.)
• Chronological ordering within sections
• Links preserved for easy navigation
• Can run for any historical week
• Output is ready to share with teams or managers