Initial commit

skills/daily-summary/assets/daily-pr-summary-template.md

@@ -0,0 +1,244 @@
+Version: 1.0
+Owner: Jeremy Miranda
+Last Updated: 2025-11-10
+
+# Daily PR Summary Template
+
+**Purpose:** Generate comprehensive daily summaries of PR activity for team standups, status reports, and progress tracking.
+
+**Usage:** Run `gh pr list --state all --limit 100 --json number,title,state,createdAt,mergedAt,author,url` and fill in sections below.
+
+---
+
+## 📊 [Project Name] - Daily PR Summary ([Date])
+
+### 🎯 Key Metrics
+
+- **PRs Created Today:** [count]
+- **PRs Merged Today:** [count]
+- **Currently Open from Today:** [count]
+- **Contributors Active:** [count] ([list names])
+
+---
+
+## ✅ PRs Merged Today ([count])
+
+### [Category 1: e.g., Performance & Optimization]
+
+1. **#[number]** - `[title]`
+   - Author: [name]
+   - Merged: [time]
+   - Description: [brief description]
+
+2. **#[number]** - `[title]`
+   - Author: [name]
+   - Merged: [time]
+   - Description: [brief description]
+
+### [Category 2: e.g., Bug Fixes]
+
+[Repeat pattern above]
+
+### [Category 3: e.g., Features]
+
+[Repeat pattern above]
+
+### [Category 4: e.g., UI/UX]
+
+[Repeat pattern above]
+
+### [Category 5: e.g., Documentation]
+
+[Repeat pattern above]
+
+---
+
+## 🆕 PRs Created Today ([count])
+
+### Currently Open ([count])
+
+#### **#[number]** - `[title]` [priority emoji: 🔴/🟡/🟢]
+
+- **Author:** [name]
+- **Created:** [time]
+- **Status:** OPEN
+- **Description:** [brief description]
+- **Changes:** +[lines] / -[lines] lines
+- **URL:** [link]
+
+#### **#[number]** - `[title]`
+
+[Repeat pattern above]
+
+### Merged Same Day ([count])
+
+- **#[number]** - `[title]` ✅
+- **#[number]** - `[title]` ✅
+
+### Closed Without Merge ([count])
+
+- **#[number]** - [reason for closure]
+
+---
+
+## 👥 Contributor Activity
+
+### [Contributor Name 1] ([github_username])
+
+- **Created:** [count] PRs (#[numbers])
+- **Merged:** [count] PRs (#[numbers])
+- **Focus Areas:** [list areas]
+
+### [Contributor Name 2] ([github_username])
+
+- **Created:** [count] PRs (#[numbers])
+- **Merged:** [count] PRs (#[numbers])
+- **Focus Areas:** [list areas]
+
+### [Bot/Automation Name] (Automated)
+
+- **Created:** [count] PRs (#[numbers])
+- **Merged:** [count] PRs (#[numbers])
+- **Focus Areas:** [list areas]
+
+---
+
+## 🔥 Highlights & Themes
+
+### [Theme 1: e.g., Performance Work] ([count] PRs)
+
+[Brief summary of related work]
+
+- [Key achievement 1]
+- [Key achievement 2]
+- [Key achievement 3]
+
+### [Theme 2: e.g., Feature Development] ([count] PRs)
+
+[Brief summary of related work]
+
+- [Key achievement 1]
+- [Key achievement 2]
+
+### [Theme 3: e.g., Bug Fixes] ([count] PRs)
+
+[Brief summary of related work]
+
+- [Key achievement 1]
+- [Key achievement 2]
+
+---
+
+## 📈 Impact Summary
+
+### Code Quality
+
+- ✅ [metric 1: e.g., PRs merged after review]
+- ✅ [metric 2: e.g., Test coverage improvements]
+- ✅ [metric 3: e.g., Memory leak elimination]
+- ✅ [metric 4: e.g., Performance optimizations]
+
+### User Experience
+
+- ✅ [improvement 1]
+- ✅ [improvement 2]
+- ✅ [improvement 3]
+
+### Developer Experience
+
+- ✅ [improvement 1]
+- ✅ [improvement 2]
+- ✅ [improvement 3]
+
+---
+
+## 🚀 Velocity
+
+- **Average Time to Merge:** [time range]
+- **Review Turnaround:** [description]
+- **Active Development Windows:** [time range]
+- **Deployment Frequency:** [metric if applicable]
+
+---
+
+## 📋 Action Items for Tomorrow
+
+### Ready for Review
+
+1. **PR #[number]** - [title] ([author]) - [status/notes]
+2. **PR #[number]** - [title] ([author]) - [status/notes]
+
+### Blockers
+
+- [List any blockers that need resolution]
+
+### Backlog Open PRs (Not from today)
+
+- **PR #[number]** - [title] ([category])
+- **PR #[number]** - [title] ([category])
+
+---
+
+## 📝 Notes
+
+[Any additional context, risks, or observations]
+
+---
+
+**Generated by:** [Agent/Tool name]
+**Report Date:** [YYYY-MM-DD HH:MM]
+**Data Source:** `gh pr list --state all --limit 100`
+
+---
+
+## Instructions for Agents
+
+### Data Collection
+
+```bash
+# Fetch PR data
+gh pr list --state all --limit 100 --json number,title,state,createdAt,mergedAt,author,url
+
+# Filter for today's date
+# Compare createdAt and mergedAt timestamps against current date
+```
+
+### Categorization Rules
+
+1. **Performance & Optimization:** PRs with keywords: perf, optimize, memory, performance, speed
+2. **Bug Fixes:** PRs with keywords: fix, bug, resolve, issue
+3. **Features:** PRs with keywords: feat, feature, add, implement
+4. **UI/UX:** PRs with keywords: ui, ux, design, animation, responsive
+5. **Documentation:** PRs with keywords: docs, documentation, readme, comments
+
+### Priority Indicators
+
+- 🔴 **HIGH PRIORITY:** Breaking changes, critical bugs, blockers
+- 🟡 **MEDIUM PRIORITY:** Features in review, non-critical bugs
+- 🟢 **LOW PRIORITY:** Documentation, minor improvements
+
+### Contributor Attribution
+
+- Track both human contributors and automated tools (bots, CI/CD)
+- Group by focus area to show specialization
+- Include both created and merged counts for full picture
+
+### Velocity Calculations
+
+- **Average Time to Merge:** Calculate from createdAt to mergedAt timestamps
+- **Review Turnaround:** Time from creation to first review comment
+- **Active Windows:** Identify peak activity hours from timestamps
+
+---
+
+**Related Templates:**
+
+- `.agents/templates/pr.md` - PR structure
+- `.agents/templates/journal.md` - Daily work log
+- `.agents/templates/review.md` - Code review format
+- `.github/PULL_REQUEST_TEMPLATE.md` - Canonical PR template
+
+**Related Skills:**
+
+- Consider creating `.agents/skills/daily-summary.md` for automation
+- Consider creating `.agents/roles/reporting-agent/` for automated generation