astronomer avatar

Tracing Downstream Lineage

Before you drop a column or refactor a DAG, this traces what downstream tables, dashboards, and ML models will break. It walks you through building a dependency tree by searching DAG source code, querying information schema for dependent views, and categorizing impact by criticality (production dashboards versus ad hoc analyst queries). The output is an impact report with a visual diagram, stakeholder list, and specific migration tasks. If you're on Astro, the Lineage tab does some of this automatically, but this skill gives you the systematic checklist for when you need to assess blast radius manually. Basically prevents the "I changed one table and now three teams are pinging me" scenario.

skills.sh installs
1.1K
GitHub stars
459
last updated
Aug 21, 2026

Install

$ npx -y skills add astronomer/agents --skill tracing-downstream-lineage --agent claude-code

Installs into .claude/skills of the current project.

Files

Downstream Lineage: Impacts

Answer the critical question: "What breaks if I change this?"

Use this BEFORE making changes to understand the blast radius.

Impact Analysis

Step 1: Identify Direct Consumers

Find everything that reads from this target:

For Tables:

  1. Search DAG source code: Look for DAGs that SELECT from this table

    • Use af dags list to get all DAGs
    • Use af dags source <dag_id> to search for table references
    • Look for: FROM target_table, JOIN target_table
  2. Check for dependent views:

    -- Snowflake
    SELECT * FROM information_schema.view_table_usage
    WHERE table_name = '<target_table>'
    
    -- Or check SHOW VIEWS and search definitions
    
  3. Look for BI tool connections:

    • Dashboards often query tables directly
    • Check for common BI patterns in table naming (rpt_, dashboard_)

On Astro

If you're running on Astro, the Lineage tab in the Astro UI provides visual dependency graphs across DAGs and datasets, making downstream impact analysis faster. It shows which DAGs consume a given dataset and their current status, reducing the need for manual source code searches.

For DAGs:

Sponsors

Details

Repository
github.com/astronomer/agents
Category
Automation & Workflows
First seen
Apr 16, 2026

More from astronomer/agents

All 24
1orchestra-research avatarcrewai-multi-agentorchestra-research/ai-research-skillsMulti-agent orchestration framework for autonomous AI collaboration. Use when building teams of specialized agents working together on complex tasks, when you n1Kskills.sh installs
2orchestra-research avatarhuggingface-accelerateorchestra-research/ai-research-skillsSimplest distributed training API. 4 lines to add distributed support to any PyTorch script. Unified API for DeepSpeed/FSDP/Megatron/DDP. Automatic device place1Kskills.sh installs
3kostja94 avatartab-accordionkostja94/marketing-skillsWhen the user wants to add or optimize tab or accordion components for content organization. Also use when the user mentions "tab component," "accordion," "expa1Kskills.sh installs
4orchestra-research avatarwhisperorchestra-research/ai-research-skillsOpenAI's general-purpose speech recognition model. Supports 99 languages, transcription, translation to English, and language identification. Six model sizes fr1Kskills.sh installs
5databricks avatardatabricks-pipelinesdatabricks/databricks-agent-skillsDevelop Lakeflow Spark Declarative Pipelines (formerly Delta Live Tables) on Databricks. Use when building batch or streaming data pipelines with Python or SQL.1Kskills.sh installs
6jezweb avatarnextjsjezweb/claude-skillsBuild Next.js 16 apps with App Router, Server Components/Actions, Cache Components ("use cache"), and async route params. Includes proxy.ts and React 19.2. Prev1Kskills.sh installs