Every product team has a meeting where a settled question rises from the dead: why is onboarding three steps? Why did we drop annual billing? The tracker records what was decided; the reasoning lived in a call nobody can replay. So the team re-litigates—with worse attendance and a colder trail of data than the first time.
Trackers store outcomes, not arguments
Specs and tickets are final artifacts, scrubbed of the debate that produced them. The user quote that swung the room, the constraint that eliminated an option, the objection someone raised and got overruled on—that context evaporates with the meeting. A new teammate reading the ticket learns the what and inherits none of the why.
Record the decision minute
Twenty seconds of voice right after the discussion: what was decided, which alternative lost and to what argument, who dissented and on what grounds. Dissent especially—today's overruled objection is next quarter's early warning.
- The decision, the losing option, and the argument that settled it.
- The evidence behind it: attach the metrics screenshot, the whiteboard photo.
- The dissent and its reason, by name.
Link the reversal to the original
Decisions get reversed; that is health, not failure. What hurts is reversing them without noticing—or re-deciding a question because nobody remembered it was settled. When a decision changes, record the new fact that changed it. Chronology keeps the current state on top while preserving the trail, and the trail is what distinguishes ‘we learned something’ from ‘we forgot why.’
Answer ‘why is it like this?’ with sources
When the question arrives—from an executive, a support escalation, an engineer reading old code—ask the history instead of your memory. The answer comes back with dates, the original discussion note, and the attached evidence, with assumptions labeled as assumptions. ‘We chose this in April over X because of Y, and it survived the June review’ closes conversations that a vibes-based recollection would reopen.
Capture the argument in the minute after the decision, attach the evidence, and link every reversal to what it reversed. Settled questions stay settled—and reopened ones reopen for a reason.