Loading

Write the sprint retro and on-call handoff

What shipped, what slipped, and what the next on-call needs to know.

10 minEngineeringClaude Cowork
Loading

Set up

Try a plugin

The Engineering plugin ships with /tech-debt and /standup already structured to read a closed cycle and a channel window and split the output into discussion themes versus operational watch-fors. If your admin manages plugins and it's not available yet, skip this step. The prompt below works without it.

EngineeringSkills for postmortems, design docs, on-call handoffs, and cost reviews
Add
/tech-debtDraft the sprint retro from the closed cycle and team channel
Open in Claude
/standupWrite the on-call handoff from the week's alerts and pages
Open in Claude

Connect your tools

Claude is more powerful when it works directly with your systems. You control permissions and access. Learn about tool access.

Add a connector for each tool you want Claude to use.

Linear
Read the closed cycle: what was planned, what shipped, what carried over and why.
Connect
Slack
Pull the team and on-call channels for the context the tickets don't capture: the why-it-slipped and the 2am page.
Connect
PagerDutyOptional
List every page in the rotation so toil is counted, not estimated.
Connect

Set your working folder

Keep your retro template, the running action-items list, and last sprint's retro in one folder. Claude reads the format from there and writes both docs back so the retro and the handoff live next to their predecessors. Create a project from the folder so your team's definition of "shipped" and the discussion-prompt style carry over every cycle.

Platform / retros / 2026-sprint-08
retro-template.mdJan 6, 20262 KB
sprint-07-retro.mdApr 13, 20266 KB
retro-action-items.mdApr 13, 20263 KB
In Cowork’s chat bar:Platform / retros / 2026-sprint-08

The prompt

Copy this into Claude

Read the just-closed Linear cycle and two weeks of #team-platform and #oncall-platform. Write the sprint retro (shipped, slipped with reasons, themes worth discussing) and a separate on-call handoff (open alerts, toil, what the next rotation should watch). Pull quotes where they help. Keep each section to what's discussable in a 30-minute meeting.

Platform / retros / 2026-sprint-08

Why this works

Prompt

Ask for the reason behind each item. The retro is about why, not the list. Asking forces the synthesis.

Prompt

Split outputs that serve different purposes. One is a conversation, one is operational. Mixing them buries both.

Prompt

Set a length limit. A length budget kills the exhaustive list and surfaces what's worth talking about.

Source

Combine complementary sources. Tickets say what moved; Slack says why. The pair is the whole story.

Get a better draft

Practice

Add an example to match. Drop an example you like into the folder and Claude matches your structure and voice.

Practice

Ask it to flag uncertainty. Add "flag anything you're not confident about" so you know where to look first when you review the draft.

Make Claude work for you

A plugin skill is a starting point. Customize it with your own practices and expertise, or save what you've done as a skill of your own. A few minutes of conversation and it runs with your standards from then on.

Make what we've done in this task so far into a skill, or edit the /tech-debt skill with my feedback.

Platform / retros

Make it repeatable

Run it when the cycle closes

Retro prep shouldn't be the TPM's Friday afternoon. Ask Claude to set up a scheduled task, or open Scheduled in the sidebar, and the customized skill drafts both docs the moment the cycle ends.

Set up a scheduled task for every Friday at 3pm: run /tech-debt on the cycle that just closed and /standup on the last two weeks, write both to Platform/retros/<sprint>/, and post the handoff to #oncall-platform.

Platform / retros
Scheduled taskActive
Sprint retro + on-call handoff

At cycle close, runs /tech-debt and /standup, writes both to the dated retro folder, and posts the handoff to the on-call channel.

Every Friday at 3:00pmOpen in Claude

Share with your teammates

Your customized /tech-debt now knows your tracker, your channels, your template, and what counts as a theme versus a status update. Share it so every squad runs the same retro prep and on-call handoffs read the same way org-wide.

What changes for retro day