benmatselby/dotfiles/summarise-diary

Summarise diary entries for a monthly performance review.

Instructions

1. Parse the arguments: $ARGUMENTS should be in format YYYY/MM (e.g., 2025/01). If not fully specified, default to the current year and/or month.

1. Read all files in diary/YYYY/MM/ EXCEPT for mpc-MM-YYYY.md (e.g., mpc-01-2025.md for January 2025). That file is the output target.

1. Generate a summary under these headings:

• Projects: What I worked on, progress made, blockers encountered
• Team: Collaboration, support given/received, team interactions
• Tech Leads: Work with/for tech leads, technical decisions, architecture discussions
• Department: Broader department initiatives, cross-team work, process improvements

1. Be concise but specific. Include concrete examples and names where they appear in the entries.

1. Save the summary to diary/YYYY/MM/mpc-MM-YYYY.md (e.g., diary/2025/01/mpc-01-2025.md). If the file exists, overwrite it.

Output format

Use markdown. Start with a heading for the month (e.g. # January 2025).