Data Lineage Explanation
Overview
Document and explain data traceability and lineage across financial institution data ecosystems. This skill applies BCBS 239 (Principles for Effective Risk Data Aggregation and Risk Reporting), FFIEC IT Examination Handbook (Information Security and Operations booklets), and COSO Principle 13 (uses relevant, quality information) to produce clear, auditable data lineage documentation supporting regulatory reporting, model risk management, and data governance programs.
When to Use
- Documenting data lineage for regulatory reports (Call Reports, FR Y-9C, CCAR/DFAST)
- Tracing data from source systems through transformations to consumption points
- Assessing data quality risks in critical data elements used for risk management
- Supporting model risk management with data provenance documentation (SR 11-7)
- Responding to regulatory findings on data governance or data quality
- Preparing for BCBS 239 compliance assessments
- Explaining data flows to non-technical stakeholders, auditors, or examiners
Required Inputs
- Data element(s): Specific data fields, metrics, or reports to trace
- System inventory: Source systems, data warehouses, ETL pipelines, reporting platforms
- Transformation logic: Business rules, calculations, aggregations, derivations
- Data dictionaries: Field definitions, data types, valid values, business glossary
- Governance documentation: Data ownership, stewardship assignments, quality thresholds
- Regulatory context: Applicable reporting requirements and submission deadlines
Methodology
Step 1: Scope and Critical Data Element Identification
Define the scope of the lineage documentation effort:
- Identify the target report, metric, or data asset requiring lineage documentation
- Enumerate the Critical Data Elements (CDEs) that comprise or feed into the target
- Classify each CDE by regulatory significance: Tier 1 (direct regulatory submission fields), Tier 2 (inputs to regulatory calculations), Tier 3 (operational data supporting risk management)
- Prioritize lineage documentation based on materiality, regulatory sensitivity, and known data quality issues
- Map CDEs to the institution's enterprise data model and business glossary
Step 2: Source System Identification and Authoritative Source Designation
Trace each CDE to its system of origin:
- Identify the authoritative source (golden source) for each data element
- Document alternative sources and reconciliation requirements where multiple sources exist
- Capture source system metadata: platform, database, schema, table, field, data type, refresh frequency
- Assess source system reliability: uptime SLA, known data quality issues, change management processes
- Document manual data entry points and associated control risks
- Identify any third-party data feeds and their SLA/quality commitments
Step 3: Transformation and Business Rule Documentation
Document every transformation between source and consumption:
- Extraction: How data is pulled from source systems (API, direct query, file transfer, CDC)
- Transformation: Business rules applied, calculations performed, data type conversions, field mappings
- Loading: Target system ingestion process, conflict resolution rules, historical preservation approach
- Aggregation: Summarization logic, grouping criteria, hierarchical roll-up rules
- Derivation: Calculated fields, proxy methodologies, estimation techniques
- Filtering: Inclusion/exclusion criteria, date range parameters, entity scope
For each transformation, document: unique ID, input and output fields, business rule (plain language), technical implementation reference, business and technical owners, and change control process.
Step 4: Data Quality Control Point Mapping
Identify and document data quality controls along the lineage path:
- Completeness checks: Null/blank validation, mandatory field enforcement, record count reconciliation
- Accuracy checks: Reasonableness testing, cross-system reconciliation, historical trend comparison
- Timeliness checks: SLA monitoring, data freshness indicators, latency measurement
- Consistency checks: Cross-field validation, referential integrity, format standardization
- Validity checks: Domain validation, business rule compliance, regulatory code validation
Map each control to COSO Principle 13 requirements and BCBS 239 principles (accuracy, completeness, timeliness, adaptability).
Step 5: Data Flow Visualization
Create layered documentation: Level 1 — Conceptual (major system boundaries for executive audiences), Level 2 — Logical (specific data elements, transformation points, quality gates for management/auditors), Level 3 — Physical (tables, fields, ETL jobs, scheduling for technology teams). Use consistent notation: rectangles for systems, diamonds for transformations, circles for quality checkpoints, labeled arrows for data flow direction.
Step 6: BCBS 239 Compliance Assessment
Evaluate lineage completeness against BCBS 239 principles:
| Principle |
Assessment Question |
| Accuracy |
Can the data be traced to authoritative sources with documented transformations? |
| Completeness |
Does the lineage cover all CDEs with no undocumented transformations? |
| Timeliness |
Are data freshness requirements documented with SLA monitoring? |
| Adaptability |
Can the lineage accommodate ad-hoc reporting requests and stress scenarios? |
| Governance |
Are data owners, stewards, and quality thresholds clearly assigned? |
Step 7: Lineage Documentation and Narrative Generation
Produce final documentation combining technical lineage with business-context narrative:
- Write plain-language explanations of each data flow segment for non-technical audiences
- Document assumptions, limitations, and known data quality risks
- Include attestation requirements for data owners and stewards
- Reference applicable regulatory requirements and examination expectations
- Provide maintenance and update procedures for keeping lineage current
Output Specification
# Data Lineage Report: [Report/Metric Name]
## Executive Summary
[Plain-language overview of the data flow, key systems, and governance structure]
## Critical Data Elements
| CDE | Business Definition | Authoritative Source | Regulatory Tier | Data Owner |
|-----|-------------------|---------------------|-----------------|------------|
## Data Flow Narrative
### Source Layer
[Description of originating systems and data capture]
### Transformation Layer
[Business rules, calculations, and aggregation logic in plain language]
### Consumption Layer
[Final reporting, dashboards, regulatory submissions]
## Data Flow Diagram
[Level 1 conceptual diagram description or reference]
## Transformation Inventory
| Step | Input | Transformation | Output | Business Rule | Owner |
|------|-------|---------------|--------|---------------|-------|
## Data Quality Controls
| Control Point | Type | Description | Threshold | Frequency | Owner |
|--------------|------|-------------|-----------|-----------|-------|
## BCBS 239 Compliance Assessment
| Principle | Status | Gaps | Remediation |
|-----------|--------|------|-------------|
## Known Limitations and Risks
[Documented gaps, manual interventions, single points of failure]
## Governance
| Role | Name | Responsibilities |
|------|------|-----------------|
| Data Owner | [name] | Accountable for data quality and fitness for purpose |
| Data Steward | [name] | Day-to-day data quality monitoring and issue resolution |
| Technical Owner | [name] | System and pipeline maintenance, change management |
## Maintenance Schedule
[Frequency and triggers for lineage documentation updates]
Analysis Framework
Data lineage maturity assessment model:
| Maturity Level |
Characteristics |
| Level 1 — Ad Hoc |
Lineage is tribal knowledge, undocumented, person-dependent |
| Level 2 — Documented |
Lineage documented manually, updated periodically, gaps remain |
| Level 3 — Managed |
Lineage systematically maintained, quality controls in place, owner accountability |
| Level 4 — Automated |
Lineage auto-discovered and maintained by tooling, integrated with data catalog |
| Level 5 — Optimized |
Real-time lineage, impact analysis capabilities, proactive quality monitoring |
Examples
Example 1 — Regulatory Report Lineage:
"The Tier 1 Capital Ratio reported on the FR Y-9C (Schedule HC-R) originates from three authoritative sources: (1) General Ledger (SAP) provides Common Equity Tier 1 capital components from GL accounts 3000-3199, aggregated through the Finance Data Warehouse using business rules documented in ETL Job FDW-CAP-001; (2) Risk-Weighted Assets are calculated by the credit risk engine (Moody's RiskAuthority) using exposure data from the loan origination system, with risk weights applied per Basel III standardized approach; (3) Regulatory adjustments are manually entered by the Capital Management team using a controlled spreadsheet with dual-approval workflow. All three data streams converge in the Regulatory Reporting Platform (AxiomSL) where final reconciliation occurs against the prior quarter submission with a ±2% variance threshold."
Example 2 — Data Quality Risk Identification:
"Lineage analysis of the allowance for credit losses (ACL) model reveals an undocumented manual override step between the model output and the final GL posting. The Portfolio Management team applies qualitative adjustment factors via an uncontrolled Excel spreadsheet that is not subject to the institution's model risk management framework (SR 11-7). This represents a data quality risk as: (1) the override logic is not version-controlled, (2) no reconciliation exists between the model output and adjusted values, (3) the qualitative factors lack documented methodology. Recommend: formalize the qualitative adjustment process within the model governance framework and implement automated reconciliation controls."
Guidelines
- Always trace lineage from authoritative source to final consumption; never assume intermediate systems are well-documented
- Use plain language for business-context narratives; reserve technical detail for Level 3 documentation
- Explicitly document manual intervention points as they represent elevated data quality and operational risk
- Ensure lineage documentation is version-controlled and updated in response to system changes, regulatory updates, or data quality incidents
- Consider lineage for both batch and real-time data flows
- Engage data owners in validating lineage accuracy; technology teams alone cannot confirm business rule correctness
- Highlight any "dark data" — data flows that exist but are not governed, monitored, or documented
Validation Checklist
1---2name: data-lineage-explanation3description: Explain data traceability and lineage for financial institution data assets. Use when documenting data flows for regulatory reporting, tracing data from source to consumption, assessing data quality risks, supporting model risk management, or responding to BCBS 239 and FFIEC data governance expectations.45metadata:6 display_name: "Data Lineage Explanation"7 short_description: "Explain data lineage and traceability for bank reporting"8 default_prompt: "Explain my data lineage in simple words and next steps"9 version: "1.0.1"10 tags:11 - financial-services12 icon_path: "assets/icon.png"13---1415# Data Lineage Explanation1617## Overview1819Document and explain data traceability and lineage across financial institution data ecosystems. This skill applies BCBS 239 (Principles for Effective Risk Data Aggregation and Risk Reporting), FFIEC IT Examination Handbook (Information Security and Operations booklets), and COSO Principle 13 (uses relevant, quality information) to produce clear, auditable data lineage documentation supporting regulatory reporting, model risk management, and data governance programs.2021## When to Use2223- Documenting data lineage for regulatory reports (Call Reports, FR Y-9C, CCAR/DFAST)24- Tracing data from source systems through transformations to consumption points25- Assessing data quality risks in critical data elements used for risk management26- Supporting model risk management with data provenance documentation (SR 11-7)27- Responding to regulatory findings on data governance or data quality28- Preparing for BCBS 239 compliance assessments29- Explaining data flows to non-technical stakeholders, auditors, or examiners3031## Required Inputs3233- **Data element(s)**: Specific data fields, metrics, or reports to trace34- **System inventory**: Source systems, data warehouses, ETL pipelines, reporting platforms35- **Transformation logic**: Business rules, calculations, aggregations, derivations36- **Data dictionaries**: Field definitions, data types, valid values, business glossary37- **Governance documentation**: Data ownership, stewardship assignments, quality thresholds38- **Regulatory context**: Applicable reporting requirements and submission deadlines3940## Methodology4142### Step 1: Scope and Critical Data Element Identification4344Define the scope of the lineage documentation effort:4546- Identify the target report, metric, or data asset requiring lineage documentation47- Enumerate the Critical Data Elements (CDEs) that comprise or feed into the target48- Classify each CDE by regulatory significance: Tier 1 (direct regulatory submission fields), Tier 2 (inputs to regulatory calculations), Tier 3 (operational data supporting risk management)49- Prioritize lineage documentation based on materiality, regulatory sensitivity, and known data quality issues50- Map CDEs to the institution's enterprise data model and business glossary5152### Step 2: Source System Identification and Authoritative Source Designation5354Trace each CDE to its system of origin:5556- Identify the authoritative source (golden source) for each data element57- Document alternative sources and reconciliation requirements where multiple sources exist58- Capture source system metadata: platform, database, schema, table, field, data type, refresh frequency59- Assess source system reliability: uptime SLA, known data quality issues, change management processes60- Document manual data entry points and associated control risks61- Identify any third-party data feeds and their SLA/quality commitments6263### Step 3: Transformation and Business Rule Documentation6465Document every transformation between source and consumption:6667- **Extraction**: How data is pulled from source systems (API, direct query, file transfer, CDC)68- **Transformation**: Business rules applied, calculations performed, data type conversions, field mappings69- **Loading**: Target system ingestion process, conflict resolution rules, historical preservation approach70- **Aggregation**: Summarization logic, grouping criteria, hierarchical roll-up rules71- **Derivation**: Calculated fields, proxy methodologies, estimation techniques72- **Filtering**: Inclusion/exclusion criteria, date range parameters, entity scope7374For each transformation, document: unique ID, input and output fields, business rule (plain language), technical implementation reference, business and technical owners, and change control process.7576### Step 4: Data Quality Control Point Mapping7778Identify and document data quality controls along the lineage path:7980- **Completeness checks**: Null/blank validation, mandatory field enforcement, record count reconciliation81- **Accuracy checks**: Reasonableness testing, cross-system reconciliation, historical trend comparison82- **Timeliness checks**: SLA monitoring, data freshness indicators, latency measurement83- **Consistency checks**: Cross-field validation, referential integrity, format standardization84- **Validity checks**: Domain validation, business rule compliance, regulatory code validation8586Map each control to COSO Principle 13 requirements and BCBS 239 principles (accuracy, completeness, timeliness, adaptability).8788### Step 5: Data Flow Visualization8990Create layered documentation: **Level 1 — Conceptual** (major system boundaries for executive audiences), **Level 2 — Logical** (specific data elements, transformation points, quality gates for management/auditors), **Level 3 — Physical** (tables, fields, ETL jobs, scheduling for technology teams). Use consistent notation: rectangles for systems, diamonds for transformations, circles for quality checkpoints, labeled arrows for data flow direction.9192### Step 6: BCBS 239 Compliance Assessment9394Evaluate lineage completeness against BCBS 239 principles:9596| Principle | Assessment Question |97|-----------|-------------------|98| Accuracy | Can the data be traced to authoritative sources with documented transformations? |99| Completeness | Does the lineage cover all CDEs with no undocumented transformations? |100| Timeliness | Are data freshness requirements documented with SLA monitoring? |101| Adaptability | Can the lineage accommodate ad-hoc reporting requests and stress scenarios? |102| Governance | Are data owners, stewards, and quality thresholds clearly assigned? |103104### Step 7: Lineage Documentation and Narrative Generation105106Produce final documentation combining technical lineage with business-context narrative:107108- Write plain-language explanations of each data flow segment for non-technical audiences109- Document assumptions, limitations, and known data quality risks110- Include attestation requirements for data owners and stewards111- Reference applicable regulatory requirements and examination expectations112- Provide maintenance and update procedures for keeping lineage current113114## Output Specification115116```markdown117# Data Lineage Report: [Report/Metric Name]118119## Executive Summary120[Plain-language overview of the data flow, key systems, and governance structure]121122## Critical Data Elements123| CDE | Business Definition | Authoritative Source | Regulatory Tier | Data Owner |124|-----|-------------------|---------------------|-----------------|------------|125126## Data Flow Narrative127### Source Layer128[Description of originating systems and data capture]129130### Transformation Layer131[Business rules, calculations, and aggregation logic in plain language]132133### Consumption Layer134[Final reporting, dashboards, regulatory submissions]135136## Data Flow Diagram137[Level 1 conceptual diagram description or reference]138139## Transformation Inventory140| Step | Input | Transformation | Output | Business Rule | Owner |141|------|-------|---------------|--------|---------------|-------|142143## Data Quality Controls144| Control Point | Type | Description | Threshold | Frequency | Owner |145|--------------|------|-------------|-----------|-----------|-------|146147## BCBS 239 Compliance Assessment148| Principle | Status | Gaps | Remediation |149|-----------|--------|------|-------------|150151## Known Limitations and Risks152[Documented gaps, manual interventions, single points of failure]153154## Governance155| Role | Name | Responsibilities |156|------|------|-----------------|157| Data Owner | [name] | Accountable for data quality and fitness for purpose |158| Data Steward | [name] | Day-to-day data quality monitoring and issue resolution |159| Technical Owner | [name] | System and pipeline maintenance, change management |160161## Maintenance Schedule162[Frequency and triggers for lineage documentation updates]163```164165## Analysis Framework166167Data lineage maturity assessment model:168169| Maturity Level | Characteristics |170|---------------|----------------|171| Level 1 — Ad Hoc | Lineage is tribal knowledge, undocumented, person-dependent |172| Level 2 — Documented | Lineage documented manually, updated periodically, gaps remain |173| Level 3 — Managed | Lineage systematically maintained, quality controls in place, owner accountability |174| Level 4 — Automated | Lineage auto-discovered and maintained by tooling, integrated with data catalog |175| Level 5 — Optimized | Real-time lineage, impact analysis capabilities, proactive quality monitoring |176177## Examples178179**Example 1 — Regulatory Report Lineage**:180"The Tier 1 Capital Ratio reported on the FR Y-9C (Schedule HC-R) originates from three authoritative sources: (1) General Ledger (SAP) provides Common Equity Tier 1 capital components from GL accounts 3000-3199, aggregated through the Finance Data Warehouse using business rules documented in ETL Job FDW-CAP-001; (2) Risk-Weighted Assets are calculated by the credit risk engine (Moody's RiskAuthority) using exposure data from the loan origination system, with risk weights applied per Basel III standardized approach; (3) Regulatory adjustments are manually entered by the Capital Management team using a controlled spreadsheet with dual-approval workflow. All three data streams converge in the Regulatory Reporting Platform (AxiomSL) where final reconciliation occurs against the prior quarter submission with a ±2% variance threshold."181182**Example 2 — Data Quality Risk Identification**:183"Lineage analysis of the allowance for credit losses (ACL) model reveals an undocumented manual override step between the model output and the final GL posting. The Portfolio Management team applies qualitative adjustment factors via an uncontrolled Excel spreadsheet that is not subject to the institution's model risk management framework (SR 11-7). This represents a data quality risk as: (1) the override logic is not version-controlled, (2) no reconciliation exists between the model output and adjusted values, (3) the qualitative factors lack documented methodology. Recommend: formalize the qualitative adjustment process within the model governance framework and implement automated reconciliation controls."184185## Guidelines186187- Always trace lineage from authoritative source to final consumption; never assume intermediate systems are well-documented188- Use plain language for business-context narratives; reserve technical detail for Level 3 documentation189- Explicitly document manual intervention points as they represent elevated data quality and operational risk190- Ensure lineage documentation is version-controlled and updated in response to system changes, regulatory updates, or data quality incidents191- Consider lineage for both batch and real-time data flows192- Engage data owners in validating lineage accuracy; technology teams alone cannot confirm business rule correctness193- Highlight any "dark data" — data flows that exist but are not governed, monitored, or documented194195## Validation Checklist196197- [ ] All critical data elements identified and traced to authoritative sources198- [ ] Transformation logic documented in both business and technical terms199- [ ] Data quality controls mapped along the lineage path200- [ ] Multi-level data flow diagrams created (conceptual, logical, physical)201- [ ] BCBS 239 compliance gaps identified with remediation plans202- [ ] Manual intervention points flagged with compensating controls assessed203- [ ] Data owners and stewards confirmed and accountability documented204- [ ] Known limitations and risks disclosed transparently205- [ ] Documentation maintained under version control with update triggers defined206- [ ] Narrative is accessible to non-technical audiences including examiners