seam-cross-deploy

Projects cross-deploy boundaries into OpenAPI contracts with Pact consumer-driven contract verification.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lucolucus/mismagent --skill seam-cross-deploy-lucolucus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seam-cross-deploy
Source: https://github.com/lucolucus/mismagent/tree/main/plugins/mismagent-cross-deploy/skills/seam-cross-deploy
Command: npx skills add https://github.com/lucolucus/mismagent --skill seam-cross-deploy-lucolucus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a consumer and a supplier live in independently deployed units, the boundary between them crosses the network and needs an executable contract. This Skill projects that boundary into OpenAPI schemas, per-side generated types, and Pact-based consumer-driven contract (CDC) publish/verify, so both sides can develop in parallel against a stable interface. ## Core Features & Use Cases - OpenAPI projection: Converts the consumer-owned Port signature into an OpenAPI contract with stable operationIds and schema names drawn from the ubiquitous language. - Per-side generated types: Consumer and producer each generate types from the contract, enabling parallel development against the interface. - CDC publish/verify with Pact: The consumer publishes the pact; the producer verifies it real-on-real as the D2 welding step, with additive-vs-breaking checks at merge/deploy. - Event-schema variant: For event-replication, local-first sync, or warm-standby wires, the contract becomes a versioned event schema with descriptor-reflection CDC tests (red-on-removal/red-on-rename) and a pinned delivery guarantee. - Use Case: A frontend team and a backend team deploy independently. Use this Skill to project their shared boundary into an OpenAPI contract, generate types on both sides, and gate merges on the producer verifying the consumer's published pact. ## Quick Start Ask the agent to realize the cross-deploy boundary for a feature whose manifest pins boundary.projection = cross-deploy, generating the OpenAPI contract and Pact verification. ## Quick Start Use the seam-cross-deploy skill to project the cross-deploy boundary in the building-block manifest into an OpenAPI contract with Pact consumer-driven verification.

Frequently Asked Questions about seam-cross-deploy

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

FAQPage Schema
How do I implement consumer-driven contract testing with Pact?

The consumer publishes a pact capturing its expected interactions, and the producer verifies that pact against its real implementation. In this Skill the producer-side pact verification is the D2 welding step, and the producer must turn the pact green before the consumer depends on a new contract shape.

How do I generate an OpenAPI contract from a domain boundary?

Project the consumer-owned Port signature, expressed in primitives or Published Language, into an OpenAPI schema with stable operationIds and components named after the ubiquitous language. Both sides then generate their types from that contract for parallel development.

When should I use cross-deploy projection instead of in-process?

Use cross-deploy projection when consumer and supplier live in independently deployed units and the boundary crosses the network. If boundary.projection is in-process, meaning both sides deploy together, use the lighter seam-in-process skill instead.

How do I contract-test event schemas for replication or sync?

Use descriptor-reflection CDC: load the compiled schema descriptors, such as proto FileDescriptorProto, and mutate a descriptor in memory by removing or renaming a field. The test must turn red on removal or rename, mechanically proving additive-only evolution holds.

What are the limitations of OpenAPI for cross-deploy boundaries?

OpenAPI covers only the request/response form of a cross-deploy boundary. For event-replication, local-first sync, or warm-standby coordination, the contract is a versioned event schema with a pinned delivery guarantee, decided by an ADR before the first breaking change.