linguistic-boundary-verifier

Detects foreign-language leaks across bounded contexts using language.md vocabulary definitions.

Updated Nov 19, 2020
One-click install
npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill linguistic-boundary-verifier-kwojtasinski-repo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linguistic-boundary-verifier
Source: https://github.com/kwojtasinski-repo/ECommerceApp/tree/main/.github/skills/linguistic-boundary-verifier
Command: npx skills add https://github.com/kwojtasinski-repo/ECommerceApp --skill linguistic-boundary-verifier-kwojtasinski-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In modular monoliths and bounded-context architectures, vocabulary from one module silently leaks into another through string literals, event names, and API calls, eroding linguistic boundaries. This Skill performs a strict read-only audit of those boundaries so violations are found with concrete evidence before they harden into coupling. ## Core Features & Use Cases - Cross-module boundary audit: Parses language.md files to build vocabulary inventories and relationship graphs, then detects string leaks, wrongly-directed API calls, foreign event consumption, and unpublished internal vocabulary usage. - Single-module PR check: Diffs a pull request with the --pr flag and flags new concepts that break the module's linguistic space or leak downstream language upstream. - Evidence-based reporting: Produces a linguistic-boundary-report.md with ASCII architecture diagrams, violation tables citing exact code locations, and before/after fix proposals confirmed with the user. - Use Case: Before merging a PR that adds a new event handler in the Orders module referencing Payments terminology, run the verifier in PR mode to confirm the new concept fits the Orders linguistic space. ## Quick Start Ask the assistant to run the linguistic boundary verifier on all modules, or on a single module with the --pr flag to check new concepts in a pull request.

Frequently Asked Questions about linguistic-boundary-verifier

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

FAQPage Schema
How do I check bounded context boundaries in a modular monolith?

Run the verifier against two or more modules or all modules. It reads each module's language.md, builds vocabulary inventories, and reports foreign terms found in strings, events, API calls, and class names with exact code locations.

How to validate new concepts in a pull request against module vocabulary?

Invoke the skill with a single module name and the --pr flag. It diffs the PR, extracts new class names, methods, string literals, and event types, then flags concepts inconsistent with the module's language.md linguistic space.

What is a language.md file and is it required?

A language.md file defines a module's purpose, core terms, published API vocabulary, and integration points. It is mandatory: the verifier stops and reports a gap rather than guessing when language.md files are missing or unclear.

Does the linguistic boundary verifier modify my code?

No, it is strictly read-only. It never edits files, creates patches, or outputs implementation code; it only reports violations and proposes fixes as diagrams and descriptions after user confirmation.

What types of boundary violations can be detected?

It classifies findings as string leaks from a foreign context, events consumed in foreign language, API calls in the wrong direction, internal vocabulary used where published vocabulary is required, or false positive candidates.