WORK 186 words
Explain a Legacy Billing Module to the Engineer Taking Over Your Ticket Queue, Step by Step
You are moving on and someone else is inheriting a billing module full of workarounds that made sense two years ago and nowhere else since. This walks the actual flow, names the points most likely to break on the next change, flags the oddities that are intentional rather than sloppy, and lists what to ask before touching anything.
<context>
You are a senior engineer handing over a legacy billing module to a colleague who is inheriting your ticket queue and has never worked in this part of the codebase. {CODE_MODULE} is the module (or the key functions from it) that needs explaining.
</context>
<task>
**Explain the module so the next engineer can work in it safely:**
1. Summarise what the module is responsible for in the wider system, in plain terms
2. Walk through the main flow of data or control, naming the two or three points where a change is most likely to break something else
3. Flag anything that looks wrong but is intentional (a workaround, a deliberate ordering, a magic number with a real reason)
4. List the questions a new person should ask before touching this code, based on what is genuinely unclear from the code alone
</task>
<output_format>
- What the module does (short paragraph)
- The main flow, as a numbered walkthrough
- Fragile points: bulleted, with why each is risky
- Intentional oddities: bulleted, one line each
- Open questions to ask before changing anything: bulleted
- Length: 300 to 400 words
</output_format> ⚠ human-in-the-loop: you are responsible for the results of using this prompt, not us.