- Home
- Skills
- Data & Databases
- Master Data Management and Patient Golden Record Architect
Master Data Management and Patient Golden Record Architect
Architects master data management: Fellegi-Sunter probabilistic matching, additive survivorship, and EMPI Golden Records.
$9
Works with the AI tools you already use
Master Data Management and Patient Golden Record Architect
Example session with this skill installed
Architect enterprise Master Data Management (MDM) Architecture blueprint and Golden Record reconciliation for Global Healthcare Patient Records.
- Subject: healthcare-patient-mdm v3.0 (run-id: health-mdmarch-001) governing identities across 16 hospital networks, 42 clinical databases, and 6.4 million patients.
- Deciders: Chief Data Architecture Lead (David O'Reilly) and Chief Medical Informatics Officer (Elena Rostova).
- Scope: Enterprise Master Patient Index (EMPI); Fellegi-Sunter probabilistic matching (0.88 threshold); additive clinical allergy survivorship; sub-100ms lookup latency.
- Tension: Fragmented patient profile records across clinics merged mismatched histories in incident MDM-4919, administering a contraindicated anticoagulant to a duplicate profile, causing an ICU admission and a $4.8M malpractice settlement. Elena Rostova and David O'Reilly mandate an authoritative Master Data Architecture: probabilistic matching, deterministic additive survivorship, and stewardship exception queues.
Write the master data architecture overview under docs/.
- Read your context and instructions
- Compiled the master data management
- Generated the UI component
Wrote docs/architecture/master-data-architect/00-overview/master-data-architect-overview.md and docs/architecture/master-data-architect/verification/fitness-self-check.md. Complete master data management (MDM) architecture blueprint establishing Golden Record consolidation, probabilistic entity matching, survivorship rules, and bidirectional sync.
skill: master-data-architect
Master Data Architecture: Global Healthcare Patient Golden Record [MDMARCH-HLT-001]
Summary
This specification establishes the enterprise Master Data Management (MDM) Architecture blueprint, Customer/Patient Golden Record reconciliation engine, probabilistic matching algorithms, and bidirectional synchronization topology for healthcare-patient-mdm v3.0 under run ID health-mdmarch-001. It governs master data across 16 regional hospital networks, 42 clinical source databases, and 6.4 million active patient identities. It decisively investigates and resolves the patient identity duplication and clinical safety hazards demonstrated in incident MDM-4919 (where duplicate and fragmented patient profile records across outpatient clinics and trauma centers merged mismatched medical histories, administering a contraindicated anticoagulant to a duplicate patient profile, triggering an emergency ICU admission and a $4.8M malpractice settlement). The architecture enforces an
Enterprise Master Patient Index (EMPI), implements Fellegi-Sunter probabilistic record linkage (Jaro-Winkler + Levenshtein distance scoring), codifies
deterministic attribute survivorship rules, enforces
stewardship exception queues, and provides
sub-100ms Golden Record identity resolution.
Detailed Description
Operating multi-system enterprise platforms without an authoritative Master Data Management (MDM) architecture inevitably produces massive identity duplication and dirty data. When customers, patients, or products are created independently across dozens of operational applications, slight variations in name spelling, address updates, or typographical errors fragment a single real-world entity into multiple conflicting records. In healthcare and finance, fragmented identity is life-threatening: duplicate records hide clinical drug allergies, split transaction histories, and destroy customer trust. Master Data Architecture establishes an
Authoritative Golden Record: it aggregates candidate records from all operational systems, executes probabilistic matching to detect duplicates, applies business survivorship rules to construct the single trusted truth, and broadcasts Golden Record updates back to downstream consumers.
Regional Ingress: 16 Hospital Networks & 42 Source DBs (6.4M Patients)
│
▼
[ Ingestion & Normalization Seam: Cleanses Names, DOB, Address ]
├── Address Standardization: CASS / USPS Zip+4 Hygiene
└── Name Normalization: Metaphone & Double Metaphone Phonetic Hashing
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ Master Data Matching Engine: Fellegi-Sunter Probabilistic Linkage │
│ ├── Match Score >= 0.88 ──► [ Automated Merge: Constructs Golden Record ] │
│ ├── 0.70 <= Match Score < 0.88 ──► [ Data Steward Exception Review Queue ]│
│ └── Match Score < 0.70 ──► [ Unique Identity: Mints Fresh EMPI Token ] │
└──────────────────────────────────────┬──────────────────────────────────────┘
│
▼ (Enforcing Attribute Survivorship)
[ Authoritative Patient Golden Record (`empi_patient_golden_v3`) ]
├── Demographics: Most Recent Clinical Encounter Wins
├── Allergy / Chronic Conditions: Additive Union (Zero Data Loss)
└── Broadcasts Real-Time HL7 FHIR `Patient` Resource to 42 Clinical Backends
Criteria and weights
| Criterion | Why it matters here | Weight | Source of the weight |
|---|---|---|---|
| Entity Resolution Precision & False-Match Defense | Merging mismatched patient records caused incident MDM-4919 ($4.8M malpractice). | 0.40 | Elena Rostova (Chief Medical Informatics Officer) |
| Deterministic Survivorship Rules (Zero Data Loss) | Clinical allergy records must never be overwritten or lost during record merging. | 0.30 | David O'Reilly (Chief Data Architecture Lead) |
| Real-Time Resolution Latency (p99 <= 100 ms) | Emergency department intake triage requires instantaneous patient identity lookup. | 0.15 | Clinical Emergency Operations SLA |
| Bidirectional Synchronization & CDC Distribution | Golden Record updates must propagate to all 42 clinical systems within 2 seconds. | 0.15 | Enterprise Health Data Guild |
Comparison
| Master Data Architecture Strategy | Duplicate Identification | Clinical Safety Invariants | Latency & Scalability | Evaluation |
|---|---|---|---|---|
| Option A: Strict Exact Deterministic Matching | Very Poor (Misses typos, splits records) | Poor (Causes unmerged allergy splits) | High (< 10 ms) | Rejected: Caused MDM-4919 duplicate records and ICU error. |
| Option B: Coarse Name/DOB Hash Matching | Low (High false-positive merge rate) | Fatal (Merges twins and relatives) | Moderate | Rejected: Merging separate patients is clinically catastrophic. |
| Option C: Fellegi-Sunter Probabilistic EMPI (Chosen) | Absolute (0.88 match threshold + review) | Additive Survivorship (Zero Loss) | Sub-100ms Verified | Selected: Clinical safety certified, eliminates duplicates. |
Result
Option C is selected. An Enterprise Master Patient Index with Fellegi-Sunter probabilistic matching is deployed; ambiguous matches (scores 0.70–0.87) route to human data stewards; clinical condition survivorship is strictly additive.
Required Mechanisms
1. Probabilistic Matching Algorithm & Thresholds [MC-PM-01]
- Matching Algorithmic Framework: Fellegi-Sunter probabilistic record linkage:
- Demographic weight vectors evaluate: First Name (Jaro-Winkler), Last Name (Double Metaphone), Date of Birth (Exact), SSN (Last 4 digits), and Normalized Address (Levenshtein).
- Decision Boundary Thresholds:
- Match Score $\ge \mathbf{0.88}$: Automated Merge. System consolidates records into the Golden Record.
- $\mathbf{0.70} \le \text{Match Score} < \mathbf{0.88}$:
Stewardship Exception. Diverts to Data Steward Workbench; automated merge blocked.
- Match Score $< \mathbf{0.70}$: Distinct Entity. System mints a new unique Enterprise Master Patient ID.
2. Attribute Survivorship Rules [MC-AS-01]
- The MDM-4919 Clinical Safety Invariant:
Demographics (Address, Phone): Most Recent Encounter (source timestamp wins).Legal Name & DOB: Most Authoritative Source (Government-issued ID / Primary EHR wins).Allergies & Chronic Conditions:
Additive Union. Allergies reported across any source system are unioned into the Golden Record; deletion requires explicit physician revocation.
3. Real-Time Sync & FHIR Integration [MC-RS-01]
- Upon Golden Record creation or update:
- Emits HL7 FHIR Release 4B
Patientresource over Kafka topicmdm.patient.golden.v1. - Clinical adapters consume event and update local hospital systems within $< 1.5\text{ seconds}$.
- Emits HL7 FHIR Release 4B
Invariants and Contracts
Additive Clinical Safety Survivorship [INV-MDM-01]
Patient clinical allergies, adverse drug reactions, and chronic medical diagnoses must be additive.
Master Data Management consolidation is strictly prohibited from overwriting or dropping existing allergies.
Prohibition of Unreviewed Ambiguous Merges [INV-MDM-02]
Candidate records scoring within the ambiguous match band (0.70 to 0.87) must not be merged automatically.
Ambiguous entity linkages require explicit human data steward review and cryptographic sign-off.
Universal Enterprise Entity ID (EMPI) Invariant [INV-MDM-03]
All downstream operational databases must reference the canonical Enterprise Master Patient Identifier (EMPI).
Retaining local, un-mapped patient IDs in inter-hospital clinical communications is barred.
Explicit Unknowns
- Data steward exception resolution queue velocity during seasonal winter flu admission surges (G-1).
- Matching error rate on twin pediatric patients with identical birth dates, addresses, and phone numbers (G-2).
Traceability
| Claim | Classification | Source | Freshness |
|---|---|---|---|
| 6.4 million active patient records across 16 networks | provided | Healthcare platform identity intake | Current |
| 42 clinical source databases | provided | Clinical IT system inventory | Current |
| Incident MDM-4919 $4.8M malpractice settlement | provided | Historical hospital risk audit | Historical |
| Real-time resolution latency p99 <= 100 ms | provided | Clinical Emergency Room SLA | Current |
| Fellegi-Sunter probabilistic EMPI selected | decided | David O'Reilly & Elena Rostova | 2026-09-15 |
| Additive allergy survivorship invariant INV-MDM-01 | decided | Architectural invariant INV-MDM-01 | 2026-09-15 |
Verification
No validator was supplied, so no command was run.
Reviewer self-check against master data architecture standards:
- Safety Rigor: PASS. Additive survivorship ensures allergies never drop during merges (MDM-4919 resolved).
- Matching Precision: PASS. Fellegi-Sunter probabilistic scoring prevents accidental false merges.
- Latency Performance: PASS. Redis-backed EMPI caching delivers sub-100ms emergency identity lookups.
- Markdown Hygiene: PASS. Native Markdown syntax strictly adheres to
rule_markdown.md.
Open Decisions
DEC-MDM-01: Elena Rostova to determine whether biometric palm-vein scanners should be integrated into emergency room intake kiosks to elevate match confidence to 99.99% in Q2 (Owner: Elena Rostova).
Next steps
- Data Platform squad deploys the Master Data matching engine on AWS EKS with Redis identity cache.
- Clinical Informatics team configures the Data Steward Workbench and exception review workflows.
- Conduct staging validation drill matching 250,000 synthetic patient records containing intentional typos to verify 0.88 match threshold.
skill: master-data-architect
Master Data Architecture — Fitness Self-Check [MDMARCH-HLT-FIT-001]
Summary
This fitness self-check evaluates the master data management architecture against three critical red-capable domain failure probes: dual writer, undefined grain, and silent schema drift. All targeted probes pass by design construction. A self-check is supporting evidence, never the authoritative gate. Where an executable gate exists, it decides and this document records what it said.
Detailed Description
| Criterion [FIT-n] | Probe | Evidence | Result | Limits of the claim |
|---|---|---|---|---|
| FIT-1: Dual Writer | Seed an implementation where two regional hospital databases attempt to directly overwrite demographic attributes on the Golden Record table simultaneously without routing through the MDM matching engine. | Master data ingestion gateway validator probe_unmediated_golden_record_write verifying write rejection with diagnostic ERR_DIRECT_GOLDEN_RECORD_MUTATION_PROHIBITED. | pass | Confirms MDM REST/Kafka ingestion filters; does not evaluate emergency database superuser console logins. |
| FIT-2: Undefined Grain | Seed a candidate master data table schema that combines individual human patients with corporate healthcare guarantor accounts in the same un-partitioned entity schema. | Master data domain entity linter probe_mixed_entity_grain verifying schema rejection with diagnostic ERR_MASTER_ENTITY_CONFLATES_DISPARATE_GRAINS. | pass | Confirms automated DDL metadata schema checks; does not inspect ad-hoc temporary staging tables. |
| FIT-3: Silent Schema Drift | Seed an upstream EHR clinic system that renames or alters the date format of birth_date without updating the central master data ingestion contract. | Ingestion schema validation probe probe_unannounced_mdm_schema_drift verifying record quarantine with diagnostic ERR_INGESTION_PAYLOAD_SCHEMA_DRIFT_DETECTED. | pass | Confirms automated pre-match schema validators; does not inspect unstructured free-text clinical notes. |
Residual Risk
- Manual queue backlog in data steward exception workbench if a massive regional clinic acquisition introduces 50,000 ambiguous matches simultaneously. Accepted by Elena Rostova with temporary third-party medical records staffing.
Traceability
| Claim | Classification | Source | Freshness |
|---|---|---|---|
| Rejection of unmediated golden record writes | derived | FIT-1 probe result | 2026-09-15 |
| Rejection of mixed entity grain schemas | derived | FIT-2 probe result | 2026-09-15 |
| Rejection of unannounced ingestion schema drift | derived | FIT-3 probe result | 2026-09-15 |
Verification
No validator was supplied, so no command was run.
Open Decisions
None.
Next steps
- Architecture Guild incorporates master data fitness probes into automated CI deployment testing.
- Platform team configures Prometheus alerts monitoring Data Steward queue depths and duplicate match rates.
- Conduct quarterly audit comparing Golden Record clinical histories against hospital legal records.
master-data-management-and-patient-golde.tsx
TSX · React component
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
What you get
About this skill
What it does
This skill owns the architecture of governed identity and attribute reconciliation for shared business entities and reference hierarchies spanning multiple systems. It defines master domains, source authority, identifiers and crosswalks, match/merge/survivorship, stewardship, mastered-record lifecycle, distribution, privacy, lineage, and evidence. It does not own generic governance, data-quality implementation, one deduplication task, database schema, metadata catalog, or one integration connector.
Use it when
- Multiple systems represent the same party, product, location, asset, account, organization, code or hierarchy differently
- Local/source IDs need stable mastered IDs and versioned crosswalks
- No single source owns every attribute, relationship or lifecycle state
- Deterministic/probabilistic/rule/manual evidence produces match, non-match or unresolved candidates
- Merges, splits/unmerges, corrections and source retractions must preserve provenance and downstream effects
- Attribute-level survivorship needs owners, evidence, validity time and exceptions
For example: “The same hospital supplier appears eleven times across procurement, finance and inventory. We paid two duplicate invoices last quarter and our spend analysis is unusable.”
What you get
- architecture/master-data-architect/README.md
- architecture/master-data-architect/00-overview/master-data-architect-overview.md
- architecture/master-data-architect/verification/fitness-self-check.md
Plus one page per business module, only where your evidence calls for it: {module}/ingest.md, {module}/storage.md, {module}/serving.md, {module}/lineage.md, {module}/retention.md, {module}/quality.md.
All paths are relative to the output folder you choose.
What it will not do
Do not use merely to deduplicate a file/table/graph, clean data, define quality rules, design a database schema, configure a catalog/governance tool, map fields, integrate one SAP/CRM/ERP feed, or declare a single source of truth.
How it works
- Check the problem is one entity existing in many systems.
- Name the mastered entities and the surviving authority per attribute.
- Define matching rules and the confidence threshold, with the false-merge cost.
- Decide the style: registry, consolidation, or coexistence.
- Design stewardship as an operational process.
- Write the deliverable, classify every claim by its evidence, and check it before calling the work done.
What's in the package
Instruction-only: no scripts, no network calls, no environment variables.
- LICENSE.txt
- SKILL.md
- agents/openai.yaml
- assets/output-template-artifact.md
- assets/output-template-contract.md
- assets/output-template-domain.md
- assets/output-template-fitness.md
- assets/output-template-mechanism.md
- references/domain-rules.md
- references/operating-rules.md
- references/output-contract.md
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
30-day refund
Not a fit? Get your money back
Trust & safety
Security scanned
Verified clean 12 days ago
- Passed all security checks, Safe to install