projector-engine-integration-proof

Execute end-to-end behavioral tests for projector and runtime engine integration boundaries.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill projector-engine-integration-proof
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: projector-engine-integration-proof
Source: https://github.com/jonnymuir/Umbraco.Prism/tree/main/.claude/skills/projector-engine-integration-proof
Command: npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill projector-engine-integration-proof

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the silent failure of integration boundaries between a compiler/projector and a runtime engine, where individual unit tests pass but the combined production behavior is broken due to mismatched data shapes.

Core Features & Use Cases

  • Integration Boundary Testing: Ensures the output of the projector is natively compatible with the runtime engine.
  • Outcome-Based Assertions: Focuses on verifying business outcomes (e.g., cursor existence) rather than brittle implementation details.
  • Use Case: Use this when you have updated your workflow definition logic and need to prove that the runtime engine correctly processes the new projected output without relying on manual JSON fixtures.

Quick Start

Execute the projector-engine-integration-proof skill to verify that the current workflow compiler output correctly triggers the expected state machine transitions in the runtime engine.

Frequently Asked Questions about projector-engine-integration-proof

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

FAQPage Schema
How do I test integration between a workflow compiler and a runtime engine?

You can validate compiler and runtime engine integration by executing end-to-end behavioral tests that target state machine transitions and gateway logic, ensuring the projector output natively triggers correct execution outcomes without manual JSON fixtures.

Why do my workflow engine unit tests pass but combined production behavior fails?

Unit tests pass but combined behavior fails due to silent contract drift, where mismatched data shapes between the compiler projector and runtime engine break production behavior. End-to-end integration testing validates this boundary to prevent silent failures.

What is integration boundary testing for state machine workflows?

Integration boundary testing verifies that a workflow projector's output is natively compatible with a runtime engine. It uses outcome-based assertions, like cursor existence, rather than brittle implementation details to ensure correct state machine execution.

Do I need a testable runtime engine shim for behavioral testing?

Yes, validating compiler and engine integration requires a testable runtime engine shim and an in-memory definition store. These components allow you to assert real-world outcomes during state machine transitions and gateway logic execution.

When should I use outcome-based assertions for workflow integration testing?

Use outcome-based assertions when you need to prove a runtime engine correctly processes new projected output after updating workflow definition logic. This approach verifies business outcomes like cursor existence, avoiding brittle implementation details.