Skip to main content
Template • 6 sections

Engineering Team Weekly Update Template (2026)

The weekly team update is how engineering managers communicate progress to leadership, product partners, and the broader org. Done well, it takes 15 minutes to write and replaces hours of status meetings. Done poorly, it's either a wall of text nobody reads or a surface-level 'things are fine' that provides no value. This template hits the sweet spot: scannable at a glance, detailed enough to answer follow-up questions, and structured so you can write it quickly every Friday.

2-minute setup • No credit card required

When to use this template

Send every Friday afternoon (or Monday morning for the previous week). Share in your team's Slack channel, email it to stakeholders, or post it to Confluence/Notion. The audience is your manager, product partners, and any stakeholder who needs visibility into engineering progress.

6 sections

Template Variations

Pick the format that fits your context.

TLDR

A 2-3 line summary for executives who won't read the full update. Write this last.

Template
## TLDR

[One sentence on what shipped] · [One sentence on what's at risk or notable] · [One sentence on next week's focus]

_Example: Shipped user invitations feature to production. Payments refactor is 60% complete but blocked on third-party API migration. Next week: unblock payments and start notification system redesign._
Write this AFTER completing the rest of the update — it's a summary, not a planKeep it to 3 sentences maximum — if you can't summarize the week in 3 sentences, you need to prioritize your messageLead with the win, even in a rough week

Shipped This Week

What reached production or was completed this week. This is the headline section.

Template
## Shipped ✅

- **[Feature/Fix name]** — [1-line description + business impact]. [PR/ticket link]
- **[Feature/Fix name]** — [1-line description]. [PR/ticket link]
- **[Feature/Fix name]** — [1-line description]. [PR/ticket link]

_[X] PRs merged this week · [Y] deployments_
Frame in business terms, not technical terms: 'Users can now invite teammates' not 'Added POST /api/invitations endpoint'Include PR or ticket links for anyone who wants detailsPull PR count from Gitmore for an accurate weekly summary

In Progress

Major work items currently being built. Include completion percentage and expected delivery.

Template
## In Progress 🔄

| Item | Progress | Expected | Status |
|------|----------|----------|--------|
| [Payments refactor] | 60% | [Date] | 🟡 At risk — blocked on API migration |
| [Notification redesign] | 20% | [Date] | 🟢 On track |
| [CI pipeline optimization] | 80% | [Date] | 🟢 Ahead of schedule |
Only include major work items (3-5 max), not every ticketUse honest status colors: 🟢 On track, 🟡 At risk, 🔴 BehindFlag risks early — leadership trusts managers who surface problems before they escalate

Risks & Blockers

Anything that could delay delivery or impact quality. Include what you're doing about it.

Template
## Risks & Blockers ⚠️

- **[Risk/Blocker]** — [Impact if not resolved]. **Mitigation:** [What you're doing about it]
- **[Risk/Blocker]** — [Impact]. **Mitigation:** [Action]

_No blockers this week_ ← use when clear
Always pair a risk with a mitigation — risks without mitigations cause anxietyQuantify impact when possible: 'This could delay the launch by 1 week' is better than 'this is a risk'If you need help from another team or leadership, say so explicitly

Wins & Recognition

Call out individual and team achievements. This section builds morale and gives leadership positive stories to share.

Template
## Wins 🎉

- [Name] shipped [feature] in 2 days, beating the 1-week estimate
- Team reduced CI build time from 15 min to 4 min — saving [X] developer-hours per week
- Zero production incidents this sprint
Name specific people — public recognition mattersQuantify wins when possible (time saved, error rate reduced, user impact)Include process wins, not just feature wins — improving CI, reducing tech debt, better testing

Next Week

A brief look ahead so stakeholders know what to expect.

Template
## Next Week 📋

- Start [upcoming work item]
- Complete [in-progress item]
- [Meeting/event/milestone], e.g., 'Sprint planning Monday, demo to product Thursday'
Keep to 3-4 items — this is a preview, not a sprint planFlag any time-off or capacity changes that affect next week's output
Pro Tips

Expert advice

1

Write the update Friday afternoon while the week is fresh — takes 15 minutes vs. 30+ on Monday when you've forgotten details

2

Use Gitmore to auto-generate the 'Shipped' section from merged PRs — saves time and ensures nothing is missed

3

Keep updates consistent week to week — same format, same time, same channel. Consistency builds readership

4

If nobody reacts to your updates, ask your stakeholders: 'Is this format useful? What would you change?'

5

Archive updates in a shared doc — they become invaluable for quarterly reviews, promotion cases, and performance conversations

FAQ

Common questions

Who should read the weekly update?

Your direct manager, product partners, and any stakeholder who asks 'what is engineering working on?' The update should be public within the org (posted in a team channel) so anyone interested can follow along.

How is this different from a sprint report?

A sprint report covers a full sprint cycle (1-2 weeks) and focuses on sprint goals, velocity, and backlog. The weekly update is shorter, covers only the past week, and is written for a non-engineering audience. Teams using sprints may send a weekly update and a sprint report at the end of each sprint.

What if we didn't ship anything this week?

Report honestly. Some weeks are focused on in-progress work, planning, or tech debt. Replace the 'Shipped' section with 'Progress' and note what moved forward. 'No production deploys this week — focused on the payments refactor (now 60% complete)' is a valid update.

Should individual developers write weekly updates?

Generally no — that's what standups are for. The weekly update is a team-level summary written by the engineering manager or tech lead. Individual updates create too much overhead and overlap with standup processes.

Automate Your Git Reporting

Stop filling in templates manually. Connect your git provider and let Gitmore generate reports automatically — daily, weekly, or on demand.

Get Started Free

No credit card • No sales call • Reports in 2 minutes