01 The situation
[Set the scene: what the program relied on, which third parties were involved, and how the dependency was structured before you owned it. Write it plainly — what would you tell a peer over coffee.]
[The specific trigger — an outage, a pattern of small failures, a client complaint — that made this everyone's problem and nobody's job.]
02 What made it hard
[The real problem, stated plainly. Usually this is not technical.]
- [Constraint one — e.g. no contractual leverage over vendor response times]
- [Constraint two — e.g. failures were intermittent, so nobody could reproduce or own them]
- [Constraint three — e.g. engineering and the client both blamed the other's system]
03 What I did
[First move.] [What you actually did, and why that rather than the obvious alternative. The reasoning is the valuable part — anyone can list actions.]
[Second move.] [Same again. Where you spent your attention and what you deliberately ignored.]
[Third move.] [The judgement call. Ideally something that wasn't obviously right at the time.]
[Something honest — a call you'd make differently, a risk you took, a thing that nearly went wrong. This is the single most credible paragraph you can write.]
04 What happened
[The outcome. Numbers if you can publish them, relative framing if you can't — "cut the review cycle roughly in half" works where an absolute figure would not.]
- [Result one]
- [Result two]
- [Result three]
05 What I'd take into the next one
[Two or three sentences. Not a lesson-learned bullet list — what you actually changed about how you work because of this.]