KB article
Lineage: Tracing a Number Back to Its Sources
Lineage makes every number auditable by tracing it to sources.
arf-kbanalytical-explainabilitylineagesemantic-annotationdeterministic-query
TL;DR
- Lineage shows where a number comes from.
- AI explanations rely on clear lineage.
The problem
- Users can’t tell which tables or transformations produced a number.
- AI answers lack auditability.
Why it matters
- Lineage builds trust and enables debugging.
- It supports governance and compliance.
Symptoms
- Analysts spend time tracing calculations manually.
- AI explanations are vague or untraceable.
Root causes
- No metadata on measure lineage.
- Complex transformations without documentation.
What good looks like
- Measures list source tables and columns.
- Lineage is visible in reports and AI responses.
How to fix
- Add lineage annotations to key measures.
- Document transformation steps.
- Expose lineage in answer summaries.
Pitfalls
- Relying on external documentation only.
- Skipping lineage for derived measures.
Checklist
- Lineage documented for top KPIs.
- Transformation steps captured.
- Lineage surfaced to users.
Framework placement
Primary ARF layer: Analytical Explainability. Diagnostic bridge: semantic-reliability, execution-reliability, change-reliability.