Open handbook navigation

Situation playbooks

A complex release with risks

Complex release playbook: risk classification, readiness review, phased rollout, monitoring, rollback and communications.

For a risky release, it’s not absolute certainty that matters, but a limitation of the range and recovery time: divide the risks by user, financial, operational and technical effect; for each, set an early signal, an owner, a stop threshold, and a proven pullback path.

How to understand that the release is difficult

Main features

A difficult release is not just a big update, but a situation where a mistake will lead to serious consequences: loss of users, money, or just the nerves of the team.

Frequent signs:

  • Many changes (different modules, architectural changes)
  • No stable rollback
  • Regulatory requirements or critical bugfixes
  • Depends on the work of partners or external systems

A real example: Fintech companies roll out new payment processing for millions of users at once, one mistake is that the service is unavailable, the money is going the wrong way, customers are furious.

Types of risks

There are three types of risks:

  • Technical (bugs, failures, incompatibility with the current architecture)
  • Product (the feature does not bring benefit or breaks the usual scenario)
  • Organizational (not in time agreed with lawyers or marketing, the regulations are a hole)

What to do before the release: preparation and plan

Risk inventory

Calculate how many situations can go wrong.

  • Go through the list of changes with development, testing and support
  • Assess the criticality of each risk: what affects, how often happens
  • Create a document with clear risks and an action plan for each

Example of work: you write back for each threat. If integration fails, how fast to plug in the old one. If the new API has a bug, how long to hotfix and who the developers are on the phone.

Planning for refusal

Every complex release requires a rollback plan: how to quickly return the old version. Be sure to test in advance that returns are not only possible on paper.

Engagement and communication

Talk to the support team, the lawyers, the marketing team, and everyone should have one clear plan: who does what when they have a problem.

Casework: The mobiles roll out a feature that affects push notifications, and the team prepares email and message templates for users in advance in case of failure.


Release: Quick Decisions and Risk Response

On-duty and monitoring

On the day of release, identify the people responsible: who is responding to what indicator, who can stop the release instantly, and monitor the metrics in real time: uptime, errors, key scenarios, business indicators.

If the metrics fly away, roll back or hotfix quickly.

Example: a new shopping cart interface, and once it’s released, the conversion to pay drops by 30 percent, and within an hour, they decide to return the old version.

Communication in case of failure

Tell critical stakeholders and support about the problem, and a message saves users time and nerves.

Don’t be silent about the failure, otherwise the tide of tickets will only increase the chaos.


After the release: post-mortem and conclusions

Analysis of problems

After the release, gather everyone who participated.

  • It worked.
  • Where communication or testing failed
  • What decisions were made successfully, which were not

Make the conclusions open to the team. This is the base for preventing replays.

A good example: After a massive drop in registration, the team speeds up the process of automating tests for similar cases.

Documentation and automation

Get a checklist for the next releases, and any bug, any roundabout, any new idea, gets into this playbook.


Typical errors and anti-patterns

Rollback neglect

The most common mistake is not checking back, so you lose hours and days and sometimes data.

Underestimating the impact

After the release, it turns out that the feature affected not only its zone, but also broke another service, the result is cascade failure.

Perfectionism

Too much delay for fear of mistakes is also a risk, the main thing is to roll out corrections quickly and not to disrupt the roadmap.


FAQ

  1. How do you know if the release is really difficult? A complex release concerns critical product features, has external dependencies or limited fixing time.
  2. Do you always need a rollback plan? For a complex release, it’s a must. Without it, any bug becomes critical.
  3. What metrics to track after release? Errors, uptime, product impacting metrics (conversions, data loss), major business flows.
  4. What to do if the rollback doesn’t work? Turn on the post-mortem situation, recheck the architecture and the tests, keep the contacts on the team for urgent manual interventions.
  5. Should I postpone the release if the test is not fully completed? If the tests do not cover critical risks, the release postponement is justified, and for minor non-critical changes, phased rollout with audience restriction is allowed.
  6. How to protect users from a bug? Prepare notification templates in advance. Turn on feature toggle to disable the new feature.