on-call-handoff-patterns

name	on-call-handoff-patterns
description	Master on-call shift handoffs with context transfer, escalation procedures, and documentation. Use when transitioning on-call responsibilities, documenting shift summaries, or improving on-call processes.

On-Call Handoff Patterns

Effective patterns for on-call shift transitions, ensuring continuity, context transfer, and reliable incident response across shifts.

When to Use This Skill

• Transitioning on-call responsibilities
• Writing shift handoff summaries
• Documenting ongoing investigations
• Establishing on-call rotation procedures
• Improving handoff quality
• Onboarding new on-call engineers

Core Concepts

1. Handoff Components

Component	Purpose
Active Incidents	What's currently broken
Ongoing Investigations	Issues being debugged
Recent Changes	Deployments, configs
Known Issues	Workarounds in place
Upcoming Events	Maintenance, releases

2. Handoff Timing

Recommended: 30 min overlap between shifts

Outgoing:
├── 15 min: Write handoff document
└── 15 min: Sync call with incoming

Incoming:
├── 15 min: Review handoff document
├── 15 min: Sync call with outgoing
└── 5 min: Verify alerting setup

Templates

Template 1: Shift Handoff Document

# On-Call Handoff: Platform Team

**Outgoing**: @alice (2024-01-15 to 2024-01-22)
: @bob (2024-01-22 to 2024-01-29)
: 2024-01-22 09:00 UTC

---





No active incidents at handoff time.

---





: Investigating
: 2024-01-20
: ~0.1% of requests timing out

:

 Timeouts correlate with database backup window (02:00-03:00 UTC)
 Suspect backup process causing lock contention
 Added extra logging in PR #567 (deployed 01/21)

:

 [ ] Review new logs after tonight's backup
 [ ] Consider moving backup window if confirmed

:

 Dashboard: []()
 Thread: #platform-eng (01/20, 14:32)

---



: Monitoring
: 2024-01-18
: None yet (proactive)

:

 Memory usage growing ~5% per day
 No memory leak found in profiling
 Suspect connection pool not releasing properly

:

 [ ] Review heap dump from 01/21
 [ ] Consider restart if usage > 80%

:

 Dashboard: []()
 Analysis doc: []()

---





 : 23 minutes
 : Database connection exhaustion
 : Rolled back v2.3.4, increased pool size
 : []()
 : ENG-1230, ENG-1231

---





| Service      | Version | Time        | Notes                      |
| ------------ | ------- | ----------- | -------------------------- |
| api-gateway  | v3.2.1  | 01/21 14:00 | Bug fix for header parsing |
| user-service | v2.8.0  | 01/20 10:00 | New profile features       |
| auth-service | v4.1.2  | 01/19 16:00 | Security patch             |



 01/21: Increased API rate limit from 1000 to 1500 RPS
 01/20: Updated database connection pool max from 50 to 75



 01/20: Added 2 nodes to Kubernetes cluster
 01/19: Upgraded Redis from 6.2 to 7.0

---





: Grafana dashboards slow on Monday mornings
: Wait 5 min after 08:00 UTC for cache warm-up
: OPS-456 (P3)



:  fails intermittently in CI
: Re-run failed job (usually passes on retry)
: ENG-1200 (P2)

---



| Date        | Event                | Impact              | Contact       |
| ----------- | -------------------- | ------------------- | ------------- |
| 01/23 02:00 | Database maintenance | 5 min read-only     | @dba-team     |
| 01/24 14:00 | Major release v5.0   | Monitor closely     | @release-team |
| 01/25       | Marketing campaign   | 2x traffic expected | @platform     |

---



| Issue Type      | First Escalation     | Second Escalation |
| --------------- | -------------------- | ----------------- |
| Payment issues  | @payments-oncall     | @payments-manager |
| Auth issues     | @auth-oncall         | @security-team    |
| Database issues | @dba-team            | @infra-manager    |
| Unknown/severe  | @engineering-manager | @vp-engineering   |

---