module-boundary

Enforce service boundaries and contract integrity across modular multi-service environments.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/rivkode/reservation --skill module-boundary
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: module-boundary
Source: https://github.com/rivkode/reservation/tree/main/.claude/skills/module-boundary
Command: npx skills add https://github.com/rivkode/reservation --skill module-boundary

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

MSA ๋ฉ€ํ‹ฐ๋ชจ๋“ˆ ํ™˜๊ฒฝ์—์„œ ์„œ๋น„์Šค ๊ฐ„ ๊ฒฝ๊ณ„ ์นจ๋ฒ”์„ ๋ฐฉ์ง€ํ•˜๊ณ  ํ†ต์‹  ๊ณ„์•ฝ์˜ ์ผ๊ด€์„ฑ์„ ํ™•๋ณดํ•˜๋Š” ๋ฐ ๋„์›€์„ ์ค€๋‹ค. ์ƒˆ๋กœ์šด ์„œ๋น„์Šค ๊ฐ„ ํ†ต์‹ , contracts ๋ชจ๋“ˆ์˜ proto/์ด๋ฒคํŠธ ์ˆ˜์ •, Saga ๊ธฐ๋ฐ˜ ๋ฐ์ดํ„ฐ ์ผ๊ด€์„ฑ, Circuit Breaker, ๋ฉฑ๋“ฑ์„ฑ ์ฒ˜๋ฆฌ, ๋ชจ๋“ˆ ์˜์กด์„ฑ ๊ฒ€์ฆ, Redis Read Model ๋™๊ธฐํ™”๋ฅผ ํฌํ•จํ•œ ์šด์˜ ์‹œ๋‚˜๋ฆฌ์˜ค์— ์ ์šฉํ•œ๋‹ค.

Core Features & Use Cases

  • ์„œ๋น„์Šค ๊ฒฝ๊ณ„ ๊ฐ•์ œํ™”: contracts ๋ชจ๋“ˆ์„ ํ†ตํ•œ ๊ณต๊ฐœ ๊ณ„์•ฝ๋งŒ ๊ณต์œ ํ•˜๊ณ  ๋‚ด๋ถ€ ๋„๋ฉ”์ธ ์˜์กด์„ ๊ธˆ์ง€ํ•œ๋‹ค.
  • ํ†ต์‹  ๋ฐ ๊ณ„์•ฝ ๊ด€๋ฆฌ: gRPC, Kafka ์ด๋ฒคํŠธ, proto ๋ฐ ์ด๋ฒคํŠธ ์Šคํ‚ค๋งˆ์˜ ๋ณ€๊ฒฝ ๊ด€๋ฆฌ.
  • ๋ฐ์ดํ„ฐ ์ผ๊ด€์„ฑ ๋ฐ ๋ณด์ƒ ํŠธ๋žœ์žญ์…˜: Saga ๊ธฐ๋ฐ˜ ํ”„๋กœ์„ธ์Šค, ๋ฉฑ๋“ฑ์„ฑ ๋ณด์žฅ, ์˜์กด์„ฑ ๊ฒ€์ฆ, ArchUnit ๊ทœ์น™ ์ž๋™ ๊ฒ€์‚ฌ.
  • Read Model ๋™๊ธฐํ™”: Redis Read Model ๋™๊ธฐํ™” ์ „๋žต๊ณผ SoT/์ฝ๊ธฐ ๋ถ„๋ฆฌ์˜ ํ•„์š”์„ฑ ๋ช…์‹œ.

Quick Start

์ƒˆ๋กœ์šด ์„œ๋น„์Šค ๊ฒฝ๊ณ„ ์ž‘์—…์„ ์‹œ์ž‘ํ•  ๋•Œ ๋ชจ๋“ˆ ๊ฒฝ๊ณ„ ์Šคํ‚ฌ์„ ์ฐธ์กฐํ•˜๊ณ  ๊ณ„์•ฝ ๋ชจ๋“ˆ๊ณผ ๊ณต์œ  ๊ทœ์น™์„ ๋ฌธ์„œํ™”ํ•œ ๋’ค ํŒ€์— ์ ์šฉํ•œ๋‹ค.

Frequently Asked Questions about module-boundary

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

FAQPage Schema
How do I enforce service boundaries in a modular monorepo to prevent internal domain dependency leaks?โ–ผ

Service boundaries in a modular monorepo environment are enforced by sharing only public contracts and prohibiting internal domain dependencies. This approach validates module dependencies and applies ArchUnit rules to automatically inspect and prevent boundary violations across multiple services.

How do I manage gRPC and Kafka event schema updates across multiple services without breaking contracts?โ–ผ

To manage gRPC and Kafka event schema updates across multiple services, you use a centralized contracts module to maintain consistency. This Skill governs proto and event schema modifications, enforcing contract-only sharing and validating communication workflows to prevent breaking existing integrations.

How do I maintain data consistency with Saga coordination and compensate for failed transactions in a microservices architecture?โ–ผ

Data consistency with Saga coordination in a microservices architecture is maintained by defining compensation transactions and ensuring idempotency. This Skill supports Saga-based processes and dependency validation to coordinate distributed data consistency and manage multi-service transaction failures effectively.

Does this approach work for synchronizing Redis Read Models and separating read workloads from the source of truth?โ–ผ

Yes, this approach works for synchronizing Redis Read Models by explicitly defining synchronization strategies and separating read workloads. The Skill specifies the necessity of isolating the source of truth from read operations to maintain boundary integrity and optimize query performance across services.

When should I use circuit breakers and idempotency checks for inter-service communication in an MSA environment?โ–ผ

Circuit breakers and idempotency checks for inter-service communication in an MSA environment should be used whenever new cross-service workflows are introduced. This Skill enforces these resilience patterns during contract updates and dependency validation to prevent cascading failures and duplicate processing.