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