reconciliation

Compare generated MD-DDL artifacts against baseline documentation or deployed schemas.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/Semprini/md-ddl --skill reconciliation-semprini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reconciliation
Source: https://github.com/Semprini/md-ddl/tree/main/agents/agent-artifact/skills/reconciliation
Command: npx skills add https://github.com/Semprini/md-ddl --skill reconciliation-semprini

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill bridges the gap between your ideal data model and your deployed reality by systematically comparing generated data artifacts against existing states, highlighting discrepancies and guiding their resolution.

Core Features & Use Cases

  • Artifact Comparison: Compares generated MD-DDL artifacts (e.g., DDL, schemas) against baseline documentation or live deployed schemas.
  • Gap Analysis: Identifies differences in entities, attributes, data types, and constraints.
  • Root Cause Analysis: Correlates physical differences back to logical changes defined in a lifecycle manifest, distinguishing intentional evolution from regeneration noise.
  • Use Case: After updating your canonical data model, use this Skill to ensure the newly generated database schema accurately reflects the changes and to identify any drift from the previously deployed version.

Quick Start

Use the reconciliation skill to compare generated dimensional artifacts against the baselines found in the baselines/dimensional directory for the customer domain.

Frequently Asked Questions about reconciliation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compare generated DDL artifacts against existing database schemas?

To compare generated DDL artifacts against existing schemas, use this Skill to systematically analyze MD-DDL physical artifacts against baseline documentation or live deployed schemas, producing a structured gap report that highlights discrepancies in entities, attributes, and constraints.

What is the best way to perform gap analysis between my data model and deployed schema?

Gap analysis between your data model and deployed schema is performed by comparing generated MD-DDL physical artifacts against existing states. The process identifies differences in entities, attributes, data types, and constraints, producing a structured gap report to guide resolution.

How does schema reconciliation distinguish intentional changes from regeneration noise?

Schema reconciliation distinguishes intentional changes from regeneration noise by correlating physical gaps back to logical causes defined in a lifecycle change manifest. This root cause analysis maps physical differences to intentional schema evolution documented in the manifest.

Can I use this Skill to find drift in my dimensional model after updating the canonical schema?

Yes, you can use this Skill to find drift after updating your canonical data model. It compares newly generated database schema artifacts against previously deployed versions in the baselines directory to ensure accurate reflection of changes and identify any drift.

What reference documents do I need for data reconciliation?

Data reconciliation requires specific generation skills to produce MD-DDL physical artifacts and reference documents for comparison, such as baseline documentation or live deployed schemas found in the baselines directory for the target domain.

When should I not use automated artifact comparison for schema evolution?

Automated artifact comparison should not be used when you lack a lifecycle change manifest. Without a manifest to correlate physical gaps back to logical causes, the reconciliation process cannot distinguish intentional schema evolution from regeneration noise.