Generates weekly or monthly session summaries from retrospectives and activity logs.
Generate weekly or monthly summaries from retrospectives, learnings, and activity logs.
/summary weekly # Generate current week summary
/summary monthly # Generate current month summary
/summary weekly 2026-01 # Generate for specific week/month
Output: $PROJECT_ROOT/docs/summaries/YYYY-MM-weekN.md or YYYY-MM.md
Parse arguments:
weekly → current week (Mon-Sun)monthly → current monthexport TZ='Asia/Bangkok'
YEAR=$(date '+%Y')
MONTH=$(date '+%m')
WEEK=$(date '+%V')
export TZ='Asia/Bangkok'
# Activity log entries for the period
grep "^$YEAR-$MONTH" docs/logs/activity.log
# Retrospectives for the period
find docs/retrospective/$YEAR-$MONTH -name "*.md" -type f | sort
# Learnings for the period
find docs/learnings/$YEAR-$MONTH -name "*.md" -type f | sort
# Git commits for the period
git log --oneline --since="[start-date]" --until="[end-date]"
# Knowledge base updates
git log --oneline --since="[start-date]" --until="[end-date]" -- docs/knowledge-base/
Read each retrospective/learning file and extract:
Use the template below.
git add docs/summaries/
git commit -m "docs: [weekly|monthly] summary for [period]"
# Week [N] Summary ([start-date] - [end-date])
## Overview
| Metric | Value |
|--------|-------|
| Sessions | [count] |
| Issues Closed | [count] |
| PRs Merged | [count] |
| Learnings Captured | [count] |
## Sessions
| Date | Task | Type | Status | Issue |
|------|------|------|--------|-------|
| MM-DD | [task description] | feat/fix/refactor | completed/pending | #N |
## Key Accomplishments
- [accomplishment 1]
- [accomplishment 2]
## Learnings Captured
- `docs/learnings/[path]` - [title]
## Knowledge Distilled
- `docs/knowledge-base/[topic].md` - [title]
## Decisions Made
| Decision | Context | Rationale |
|----------|---------|-----------|
| [decision] | [context] | [rationale] |
## Open Items
- [ ] [carried over items from retrospectives]
## Next Week Focus
- [suggested focus areas based on open items]
# [Month Year] Summary
## Overview
| Metric | Value |
|--------|-------|
| Total Sessions | [count] |
| Issues Closed | [count] |
| PRs Merged | [count] |
| Learnings | [count] |
| Knowledge Base Updates | [count] |
## Weekly Breakdown
| Week | Sessions | Key Focus |
|------|----------|-----------|
| W1 | [count] | [focus] |
| W2 | [count] | [focus] |
| W3 | [count] | [focus] |
| W4 | [count] | [focus] |
## Top Accomplishments
1. [accomplishment]
2. [accomplishment]
3. [accomplishment]
## Patterns & Trends
- [observed pattern in work]
- [recurring themes]
## Open Items Carried Over
- [ ] [items still pending]
## Next Month Priorities
- [priority 1]
- [priority 2]
| Command | Purpose |
|---|---|
/td | Create retrospective (data source) |
/mem | Capture learnings (data source) |
/consolidate | Consolidate auto-captured files |
/summary | Generate summaries (you are here) |