validate-completeness

Validate Event Model DSL field traceability to commands and domain events.

7|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/howarddierking/mermaid-event-model --skill validate-completeness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-completeness
Source: https://github.com/howarddierking/mermaid-event-model/tree/main/skills/validate-completeness
Command: npx skills add https://github.com/howarddierking/mermaid-event-model --skill validate-completeness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It finds missing or incorrectly linked data paths in an Event Model DSL so that every UI or read-model field is backed by upstream domain events and ultimately by commands, preventing “assumed” information.

Core Features & Use Cases

  • Field traceability analysis: verifies that each UI/read-model field can be traced backward to a domain event that supplies it.
  • Command-to-event connectivity checks: ensures every command produces at least one domain event and that every domain event is reachable from a command (or an external system event).
  • No-assumptions validation: flags fields whose dependencies are not explicitly provided anywhere in the event/command chain, except for allowed system-generated values (IDs and timestamps).
  • Orphan detection: reports disconnected commands, domain events, read models, and UIs where expected connections are absent.
  • Use case: validate a ticketing or booking event-model DSL so a rendering will not silently rely on missing fields when displaying booking screens, availability read models, or downstream automations.

Quick Start

Use validate-completeness with your Event Model DSL markdown file path, and it will generate a structured report of completeness status, trace tables, gaps, and orphan elements.

Frequently Asked Questions about validate-completeness

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

FAQPage Schema
How do I validate traceability for read model fields in an event modeling diagram?

Field traceability analysis in event modeling verifies that each UI and read-model field traces backward to a supplying domain event. It enforces case-insensitive field name matching and flags dependencies not explicitly provided in the command-to-event chain.

How do I check if every domain event is reachable from a command in Mermaid eventModel blocks?

Checking command-to-event connectivity in Mermaid eventModel blocks ensures every command produces at least one domain event and that every domain event is reachable from a command or external system event. It reports disconnected or orphan elements where expected connections are absent.

What is orphan detection in event modeling and when do I need it?

Orphan detection in event modeling identifies disconnected commands, domain events, read models, and UIs where expected connections are absent. You need it when validating ticketing or booking event-model DSL to prevent renderings that silently rely on missing fields or broken event flows.

Does event modeling completeness validation allow system-generated fields like IDs and timestamps?

Event modeling completeness validation allows explicit system-generated values like IDs and timestamps in domain events. It applies no-assumptions validation to flag all other fields whose dependencies are not explicitly provided anywhere in the upstream event and command chain.

How do I find missing data paths in an Event Model DSL before rendering booking screens?

Finding missing data paths in an Event Model DSL requires analyzing Mermaid fence contents to ensure every UI and read-model field is backed by upstream domain events and ultimately by commands. It outputs a structured summary with field trace paths plus a gaps and orphans report.

What is the best way to prevent assumed information in event-driven read models?

The best way to prevent assumed information in event-driven read models is applying no-assumptions validation to the Event Model DSL. This ensures every field is traceable to domain events and commands, explicitly allowing only system-generated identifiers and timestamps while flagging all other gaps.