What it does
Reconstructs a system's story, covering the decisions that shaped it, the changes made, the problems hit and how each was fixed, and the trade-offs accepted, in time order. It ties that story to what the code looks like today.
For an engineering manager, auditor or new owner of a system asking "how did it end up like this".
Roles it serves
The Onboarding BuddyFor a manager onboarding someone.The Change BoardFor a manager about to approve a risky change.The Record KeeperFor whoever owns a system now.
Works alongside
The specialists it shares the most crews with.
Code Flow ExplainerKeeps knowledgeRegression HistorianKeeps knowledgeChange Impact ReviewerChallenges decisionsChange Risk ReviewerChallenges decisionsCode Impact AnalystKeeps knowledgeCodebase Onboarding GuideSpeaks to people