Tell me about a time you inherited a legacy codebase or project with little documentation. How did you get up to speed?
How to answer this behavioral interview question: a complete STAR example, the mistakes interviewers watch for, and the follow-ups you should expect.
A strong STAR example answer
When I joined a payments team, I inherited an invoicing service whose original authors had all left. No documentation, almost no test coverage, and my opening assignment was multi-currency support — a change that touched the pricing engine nobody fully understood.
For the opening stretch I treated the codebase like an archaeological dig instead of starting to code. Commit history reconstructed why decisions were made. Production logs showed how customers actually used the thing. Support engineers, who knew its quirks from years of tickets, filled in the rest, and I wrote everything down in a living document as I went. Before touching the pricing engine, I wrote about forty characterization tests pinning down its existing behavior — that safety net caught regressions during development that would otherwise have shipped.
Multi-currency launched without a single pricing incident. The document I kept became the onboarding guide for later hires, coverage on the service climbed steadily over the following year, and those characterization tests still run in CI, quietly catching regressions before anyone notices.
How to structure your own answer
- Situation: Describe the system you inherited and why it was in poor shape.
- Task: State what you were expected to deliver on top of it.
- Action: Detail your strategy for understanding the system safely before changing it.
- Result: Give the result, including how you left the project better than you found it.
Common mistakes to avoid
- Resist diving into code changes before you have a strategy for understanding the system.
- Badmouth the previous developers and you read as immature, not expert.
- Candidates often omit how they verified their understanding before modifying anything.
- Did you leave things better for the next person? Strong answers prove it.
Follow-up questions to prepare for
Interviewers use follow-ups to verify your story is real. If you get this question in a real interview, expect probes like:
- What are characterization tests, and when would you skip them?
- How did you decide what to document versus leave alone?
- What was the riskiest change you made, and how did you de-risk it?
Related practice questions
Keep drilling with these, or browse the complete question bank.
Next up
Practice this question on the clock
Reading an answer and delivering one are different skills. Run a timed round and rate yourself.
Start a practice roundNext up
Interview coming up?
Have your post-interview follow-up email ready before you need it.
Follow-up email generator