linguistic-boundary-verifier

Detects linguistic leakage across bounded contexts in DDD module definitions.

Updated May 11, 2026
One-click install
npx skills add https://github.com/rafalwizen/plugin-architecture-test --skill linguistic-boundary-verifier-rafalwizen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linguistic-boundary-verifier
Source: https://github.com/rafalwizen/plugin-architecture-test/tree/main/week10/linguistic-boundary-verifier
Command: npx skills add https://github.com/rafalwizen/plugin-architecture-test --skill linguistic-boundary-verifier-rafalwizen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bounded contexts in domain-driven design architectures rely on strict language isolation to maintain low coupling, but hidden linguistic leakage (via string literals, event subscriptions, or incorrect API calls) often goes undetected by standard architectural dependency tools, leading to fragile, hard-to-refactor systems.

Core Features & Use Cases

  • Cross-module boundary auditing: Analyze relationships between 2+ modules (or all modules) to detect language leaking across context boundaries.
  • Single-module PR validation: Check new concepts added in a single-module pull request to ensure they fit the module's linguistic space and don't break existing generalizations.
  • Type-specific fix proposals: Provide tailored solutions for each violation type, including behavior generalization for string leaks, anti-corruption layer translation for event leaks, and dependency direction correction for API call leaks.
  • Use Case: A team preparing a cross-service refactor can run this skill to catch hidden language dependencies between their order management and invoicing modules before making changes.

Quick Start

Invoke the linguistic-boundary-verifier skill with the list of modules you want to audit for linguistic boundary violations to receive a detailed report of leaks and proposed fixes.

Frequently Asked Questions about linguistic-boundary-verifier

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

FAQPage Schema
How do I detect language leakage between bounded contexts in a microservices architecture?

Detect language leakage between bounded contexts by analyzing module language definition files to identify foreign string literals, misdirected event subscriptions, and incorrect API call directions. This auditing process catches hidden dependencies that standard architectural tools miss.

What is the best way to validate ubiquitous language consistency in a single-module pull request?

Validate ubiquitous language consistency in a single-module pull request by checking newly added concepts against the module's existing linguistic space. This ensures new terms fit generalizations and do not break previously established domain boundaries.

How do I audit microservices for domain-driven design boundary violations across multiple modules?

Audit microservices for domain-driven design boundary violations by running cross-module relationship analysis on two or more modules. This generates a detailed report identifying string leaks, event subscription misdirections, and incorrect API dependencies.

Can I get fix proposals for ubiquitous language leaks found during architecture validation?

You can get fix proposals for ubiquitous language leaks that include behavior generalization for string leaks, anti-corruption layer translation for event leaks, and dependency direction correction for API call leaks. These proposals provide before and after diagrams for actionable refactoring.

Why does hidden linguistic leakage make domain-driven design systems hard to refactor?

Hidden linguistic leakage makes domain-driven design systems hard to refactor because it introduces strict coupling through foreign string literals and misdirected event subscriptions that bypass architectural dependency tools. This undetected coupling degrades system stability over time.

Do I need module language definition files to check for bounded context violations?

You need module language definition files to check for bounded context violations because the analysis relies on parsing these linguistic definitions to detect foreign concepts. Without these files, the cross-module boundary audit cannot identify leakage.