Testing Best Practices
anonaddy/anonaddy
Laravel test design and review. An agent skill from anonaddy/anonaddy.
Enterprise middleware testing patterns for message routing, transformation, DLQ, protocol mediation, ESB error handling, and EIP patterns.
$ npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install proffesor-for-testing/agentic-qe middleware-testing-patterns --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/proffesor-for-testing/agentic-qe.git skills-src && mkdir -p .claude/skills && cp -r skills-src/assets/skills/middleware-testing-patterns .claude/skills/middleware-testing-patterns && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "middleware-testing-patterns" agent skill from https://github.com/proffesor-for-testing/agentic-qe/tree/main/assets/skills/middleware-testing-patterns into .claude/skills/middleware-testing-patterns/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "middleware-testing-patterns", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/proffesor-for-testing/agentic-qe/tree/main/assets/skills/middleware-testing-patternsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install proffesor-for-testing/agentic-qe middleware-testing-patterns --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proffesor-for-testing/agentic-qe.git skills-src && mkdir -p .agents/skills && cp -r skills-src/assets/skills/middleware-testing-patterns .agents/skills/middleware-testing-patterns && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "middleware-testing-patterns" agent skill from https://github.com/proffesor-for-testing/agentic-qe/tree/main/assets/skills/middleware-testing-patterns into .agents/skills/middleware-testing-patterns/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "middleware-testing-patterns", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install proffesor-for-testing/agentic-qe middleware-testing-patterns --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proffesor-for-testing/agentic-qe.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/assets/skills/middleware-testing-patterns .cursor/skills/middleware-testing-patterns && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "middleware-testing-patterns" agent skill from https://github.com/proffesor-for-testing/agentic-qe/tree/main/assets/skills/middleware-testing-patterns into .cursor/skills/middleware-testing-patterns/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "middleware-testing-patterns", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/proffesor-for-testing/agentic-qe.git --path assets/skills/middleware-testing-patterns--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install proffesor-for-testing/agentic-qe middleware-testing-patterns --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proffesor-for-testing/agentic-qe.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/assets/skills/middleware-testing-patterns .gemini/skills/middleware-testing-patterns && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "middleware-testing-patterns" agent skill from https://github.com/proffesor-for-testing/agentic-qe/tree/main/assets/skills/middleware-testing-patterns into .gemini/skills/middleware-testing-patterns/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "middleware-testing-patterns", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install proffesor-for-testing/agentic-qe middleware-testing-patternsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/proffesor-for-testing/agentic-qe.git skills-src && mkdir -p .github/skills && cp -r skills-src/assets/skills/middleware-testing-patterns .github/skills/middleware-testing-patterns && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "middleware-testing-patterns" agent skill from https://github.com/proffesor-for-testing/agentic-qe/tree/main/assets/skills/middleware-testing-patterns into .github/skills/middleware-testing-patterns/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "middleware-testing-patterns", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install proffesor-for-testing/agentic-qe middleware-testing-patterns --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proffesor-for-testing/agentic-qe.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/assets/skills/middleware-testing-patterns .opencode/skills/middleware-testing-patterns && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "middleware-testing-patterns" agent skill from https://github.com/proffesor-for-testing/agentic-qe/tree/main/assets/skills/middleware-testing-patterns into .opencode/skills/middleware-testing-patterns/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "middleware-testing-patterns", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
middleware-testing-patternsEnterprise middleware testing patterns for message routing, transformation, DLQ, protocol mediation, ESB error handling, and EIP patterns.
Middleware Testing Patterns is an agent skill from proffesor-for-testing/agentic-qe. Enterprise middleware testing patterns for message routing, transformation, DLQ, protocol mediation, ESB error handling, and EIP patterns. Use when testing middleware layers, message brokers, ESBs, or integration buses.
Its SKILL.md is about 7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `evals/middleware-testing-patterns.yaml`, `schemas/output.json` and `scripts/validate-config.json`).
It sits in Testing & QA, covering Test strategy, Event-driven systems and Dispute resolution. The repository describes itself as: Agentic QE Fleet is an open-source AI-powered QA/QE platform designed for use with Coding Agents (works best with Claude Code) featuring specialized agents and skills to support… The licence is MIT.
7 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 829d030. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/, which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
schemas.xmlsoap.orgFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Middleware Testing Patterns loads about 7k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 656 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from proffesor-for-testing/agentic-qe at commit 829d030, republished under its MIT licence (© proffesor-for-testing). 656 words, ~7,002 tokens.
.claude/skills/middleware-testing-patterns/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.<default_to_action> When testing enterprise middleware, ESBs, or message-driven systems:
Quick Pattern Selection:
Critical Success Factors:
| Level | Purpose | Dependencies | Speed |
|---|---|---|---|
| Unit Transform | Single mapping correctness | None | Fast |
| Route Logic | Routing decision accuracy | Mocked endpoints | Fast |
| Integration | End-to-end message flow | Broker + endpoints | Medium |
| DLQ/Error | Error handling and recovery | Full middleware stack | Slower |
| Scenario | Must Test | Example |
|---|---|---|
| Routing | Correct destination selection | Order type A -> Queue A, type B -> Queue B |
| Transformation | Schema compliance after mapping | XML -> JSON field mapping accuracy |
| DLQ | Poison message handling | Malformed XML lands in DLQ, not lost |
| Ordering | Sequence preservation | Messages 1-2-3 arrive in order |
| Correlation | Multi-hop tracing | Request-reply matched by correlation ID |
| Retry | Transient failure recovery | 3 retries with backoff, then DLQ |
| Mediation | Protocol bridging fidelity | SOAP request produces correct REST call |
qe-middleware-validator: Validate routing rules, transformation accuracy, EIP patternsqe-message-broker-tester: Test broker connectivity, DLQ behavior, message orderingqe-soap-tester: SOAP/WSDL validation, WS-Security, protocol mediationdescribe('Content-Based Router - Order Type', () => {
it('routes standard orders to fulfillment queue', async () => {
const message = {
correlationId: uuid(),
body: { orderType: 'STANDARD', orderId: 'ORD-001', items: [{ sku: 'A1', qty: 2 }] }
};
await broker.publish('orders.inbound', message);
const routed = await broker.consume('orders.fulfillment', { timeout: 5000 });
expect(routed.body.orderId).toBe('ORD-001');
expect(routed.correlationId).toBe(message.correlationId);
const dlq = await broker.tryConsume('orders.dlq', { timeout: 1000 });
expect(dlq).toBeNull(); // Nothing in DLQ
});
it('routes express orders to priority queue', async () => {
const message = {
correlationId: uuid(),
body: { orderType: 'EXPRESS', orderId: 'ORD-002', items: [{ sku: 'B1', qty: 1 }] }
};
await broker.publish('orders.inbound', message);
const routed = await broker.consume('orders.priority', { timeout: 5000 });
expect(routed.body.orderId).toBe('ORD-002');
});
it('sends unrecognized order types to DLQ', async () => {
const message = {
correlationId: uuid(),
body: { orderType: 'UNKNOWN', orderId: 'ORD-003' }
};
await broker.publish('orders.inbound', message);
const dlqMessage = await broker.consume('orders.dlq', { timeout: 5000 });
expect(dlqMessage.body.orderId).toBe('ORD-003');
expect(dlqMessage.headers['x-error-reason']).toContain('Unrecognized orderType');
});
});describe('Header-Based Router - Region', () => {
it('routes by x-region header to regional queues', async () => {
const regions = ['US', 'EU', 'APAC'];
for (const region of regions) {
const message = {
headers: { 'x-region': region },
body: { orderId: `ORD-${region}` }
};
await broker.publish('orders.global', message);
const routed = await broker.consume(`orders.${region.toLowerCase()}`, { timeout: 5000 });
expect(routed.body.orderId).toBe(`ORD-${region}`);
}
});
it('routes messages without region header to default queue', async () => {
await broker.publish('orders.global', { body: { orderId: 'ORD-NO-REGION' } });
const routed = await broker.consume('orders.default', { timeout: 5000 });
expect(routed.body.orderId).toBe('ORD-NO-REGION');
});
});describe('Recipient List - Order Notifications', () => {
it('fans out order to all registered recipients', async () => {
const message = {
body: { orderId: 'ORD-100', total: 250.00 }
};
await broker.publish('orders.confirmed', message);
// All three systems should receive the message
const [warehouse, billing, crm] = await Promise.all([
broker.consume('notify.warehouse', { timeout: 5000 }),
broker.consume('notify.billing', { timeout: 5000 }),
broker.consume('notify.crm', { timeout: 5000 })
]);
expect(warehouse.body.orderId).toBe('ORD-100');
expect(billing.body.orderId).toBe('ORD-100');
expect(crm.body.orderId).toBe('ORD-100');
});
});describe('JSON to XML Transformation', () => {
it('transforms order JSON to SAP XML format', async () => {
const jsonInput = {
orderId: 'ORD-500',
customer: { id: 'CUST-01', name: 'Acme Corp' },
items: [
{ sku: 'MAT-100', quantity: 10, unitPrice: 25.00 }
]
};
await broker.publish('transform.json-in', { body: jsonInput });
const xmlOutput = await broker.consume('transform.xml-out', { timeout: 5000 });
const parsed = parseXml(xmlOutput.body);
expect(parsed.SalesOrder.OrderNumber).toBe('ORD-500');
expect(parsed.SalesOrder.SoldToParty.CustomerID).toBe('CUST-01');
expect(parsed.SalesOrder.Items.Item[0].MaterialNumber).toBe('MAT-100');
expect(parsed.SalesOrder.Items.Item[0].Quantity).toBe('10');
});
it('handles missing optional fields gracefully', async () => {
const jsonInput = {
orderId: 'ORD-501',
customer: { id: 'CUST-02' }, // name is missing
items: [{ sku: 'MAT-200', quantity: 5 }] // unitPrice missing
};
await broker.publish('transform.json-in', { body: jsonInput });
const xmlOutput = await broker.consume('transform.xml-out', { timeout: 5000 });
const parsed = parseXml(xmlOutput.body);
expect(parsed.SalesOrder.SoldToParty.Name).toBe(''); // Default empty
expect(parsed.SalesOrder.Items.Item[0].UnitPrice).toBe('0.00');
});
it('rejects invalid input and sends to DLQ with error details', async () => {
const invalidInput = { items: [] }; // Missing required orderId and customer
await broker.publish('transform.json-in', { body: invalidInput });
const dlq = await broker.consume('transform.dlq', { timeout: 5000 });
expect(dlq.headers['x-error-reason']).toContain('orderId is required');
});
});describe('Flat-File to XML Transformation', () => {
it('parses fixed-width flat file into structured XML', async () => {
// Fixed-width: positions 1-10 = orderId, 11-20 = sku, 21-25 = qty
const flatFile = 'ORD-001 MAT-10000010\nORD-001 MAT-20000005\n';
await broker.publish('transform.flatfile-in', { body: flatFile });
const xmlOutput = await broker.consume('transform.flatfile-xml-out', { timeout: 5000 });
const parsed = parseXml(xmlOutput.body);
expect(parsed.Orders.Order).toHaveLength(1);
expect(parsed.Orders.Order[0].Items.Item).toHaveLength(2);
expect(parsed.Orders.Order[0].Items.Item[0].Quantity).toBe('10');
});
it('handles lines with trailing whitespace correctly', async () => {
const flatFile = 'ORD-002 MAT-30000001 \n';
await broker.publish('transform.flatfile-in', { body: flatFile });
const xmlOutput = await broker.consume('transform.flatfile-xml-out', { timeout: 5000 });
const parsed = parseXml(xmlOutput.body);
expect(parsed.Orders.Order[0].OrderId).toBe('ORD-002');
expect(parsed.Orders.Order[0].Items.Item[0].Quantity).toBe('1');
});
});describe('Dead Letter Queue Strategy', () => {
it('moves message to DLQ after max retries', async () => {
// Configure endpoint to always fail
mockEndpoint.respondWith(500, 'Service Unavailable');
await broker.publish('orders.process', {
body: { orderId: 'ORD-FAIL' },
headers: { 'x-correlation-id': 'corr-123' }
});
// Wait for retries to exhaust (3 retries with backoff)
const dlqMessage = await broker.consume('orders.dlq', { timeout: 30000 });
expect(dlqMessage.body.orderId).toBe('ORD-FAIL');
expect(dlqMessage.headers['x-retry-count']).toBe('3');
expect(dlqMessage.headers['x-original-queue']).toBe('orders.process');
expect(dlqMessage.headers['x-correlation-id']).toBe('corr-123');
expect(dlqMessage.headers['x-error-reason']).toContain('Service Unavailable');
expect(dlqMessage.headers['x-first-failure-timestamp']).toBeDefined();
});
it('preserves original message body in DLQ', async () => {
const originalBody = {
orderId: 'ORD-PRESERVE',
items: [{ sku: 'A', qty: 1 }, { sku: 'B', qty: 2 }]
};
mockEndpoint.respondWith(500, 'Timeout');
await broker.publish('orders.process', { body: originalBody });
const dlqMessage = await broker.consume('orders.dlq', { timeout: 30000 });
expect(dlqMessage.body).toEqual(originalBody); // Body unchanged
});
it('DLQ messages can be replayed after fix', async () => {
// Step 1: Message fails, lands in DLQ
mockEndpoint.respondWith(500, 'Down');
await broker.publish('orders.process', { body: { orderId: 'ORD-REPLAY' } });
const dlqMessage = await broker.consume('orders.dlq', { timeout: 30000 });
// Step 2: Fix the endpoint
mockEndpoint.respondWith(200, 'OK');
// Step 3: Replay from DLQ
await broker.publish('orders.process', dlqMessage);
const success = await broker.consume('orders.completed', { timeout: 5000 });
expect(success.body.orderId).toBe('ORD-REPLAY');
});
});describe('Message Ordering Validation', () => {
it('preserves FIFO order within same partition key', async () => {
const messages = Array.from({ length: 10 }, (_, i) => ({
headers: { 'x-partition-key': 'ORDER-GROUP-1', 'x-sequence': String(i + 1) },
body: { orderId: `ORD-${i + 1}`, sequence: i + 1 }
}));
for (const msg of messages) {
await broker.publish('orders.sequenced', msg);
}
const received = [];
for (let i = 0; i < 10; i++) {
const msg = await broker.consume('orders.sequenced.out', { timeout: 5000 });
received.push(msg.body.sequence);
}
expect(received).toEqual([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
});
it('detects out-of-order messages via sequence gap', async () => {
// Send messages 1, 2, 4 (skip 3)
for (const seq of [1, 2, 4]) {
await broker.publish('orders.sequenced', {
headers: { 'x-partition-key': 'GROUP-2', 'x-sequence': String(seq) },
body: { sequence: seq }
});
}
// The middleware should detect the gap and raise an alert
const alert = await broker.consume('orders.sequence-gap', { timeout: 10000 });
expect(alert.body.missingSequence).toBe(3);
expect(alert.body.partitionKey).toBe('GROUP-2');
});
});describe('Compensation Pattern - Saga', () => {
it('compensates completed steps when a later step fails', async () => {
// Saga: Reserve Inventory -> Charge Payment -> Ship
// If Ship fails, Payment and Inventory must be compensated
mockServices.inventory.respondWith(200); // Step 1 succeeds
mockServices.payment.respondWith(200); // Step 2 succeeds
mockServices.shipping.respondWith(500); // Step 3 fails
await broker.publish('saga.order', {
body: { orderId: 'ORD-SAGA', amount: 100.00 }
});
// Verify compensation messages were sent
const paymentRefund = await broker.consume('saga.compensate.payment', { timeout: 10000 });
expect(paymentRefund.body.action).toBe('REFUND');
expect(paymentRefund.body.orderId).toBe('ORD-SAGA');
const inventoryRelease = await broker.consume('saga.compensate.inventory', { timeout: 10000 });
expect(inventoryRelease.body.action).toBe('RELEASE');
expect(inventoryRelease.body.orderId).toBe('ORD-SAGA');
});
});describe('SOAP to REST Protocol Mediation', () => {
it('converts SOAP request to REST call and back', async () => {
const soapRequest = `
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ord="http://example.com/orders">
<soapenv:Body>
<ord:GetOrder>
<ord:OrderId>ORD-700</ord:OrderId>
</ord:GetOrder>
</soapenv:Body>
</soapenv:Envelope>
`;
// ESB should convert SOAP -> REST GET /orders/ORD-700
mockRestBackend.onGet('/orders/ORD-700').reply(200, {
orderId: 'ORD-700',
status: 'SHIPPED',
total: 150.00
});
const response = await soapClient.send(soapRequest, { endpoint: esbSoapEndpoint });
// Verify SOAP response wraps REST data correctly
const parsed = parseSoapResponse(response);
expect(parsed.OrderId).toBe('ORD-700');
expect(parsed.Status).toBe('SHIPPED');
expect(parsed.Total).toBe('150.00');
});
it('maps REST error to SOAP fault', async () => {
const soapRequest = buildSoapGetOrder('ORD-NOTFOUND');
mockRestBackend.onGet('/orders/ORD-NOTFOUND').reply(404, {
error: 'Order not found'
});
const response = await soapClient.send(soapRequest, { endpoint: esbSoapEndpoint });
const fault = parseSoapFault(response);
expect(fault.faultCode).toBe('Client');
expect(fault.faultString).toContain('Order not found');
});
});describe('Sync to Async Mediation', () => {
it('accepts sync request, returns correlation ID, delivers result async', async () => {
// Client sends synchronous HTTP POST
const response = await httpClient.post(`${esbEndpoint}/async-orders`, {
orderId: 'ORD-ASYNC',
items: [{ sku: 'X1', qty: 5 }]
});
// ESB returns 202 Accepted with correlation ID
expect(response.status).toBe(202);
expect(response.body.correlationId).toBeDefined();
const correlationId = response.body.correlationId;
// Result arrives asynchronously on callback queue
const result = await broker.consume('orders.async.results', {
timeout: 15000,
filter: (msg) => msg.headers['x-correlation-id'] === correlationId
});
expect(result.body.orderId).toBe('ORD-ASYNC');
expect(result.body.status).toBe('ACCEPTED');
});
});describe('Splitter - Batch Order to Individual Items', () => {
it('splits batch order into individual item messages', async () => {
const batchOrder = {
orderId: 'BATCH-001',
items: [
{ sku: 'A1', qty: 10 },
{ sku: 'B2', qty: 5 },
{ sku: 'C3', qty: 20 }
]
};
await broker.publish('orders.batch', { body: batchOrder });
const splitMessages = [];
for (let i = 0; i < 3; i++) {
splitMessages.push(await broker.consume('orders.items', { timeout: 5000 }));
}
expect(splitMessages).toHaveLength(3);
expect(splitMessages.map(m => m.body.sku).sort()).toEqual(['A1', 'B2', 'C3']);
// Each split message retains parent correlation
for (const msg of splitMessages) {
expect(msg.headers['x-batch-id']).toBe('BATCH-001');
expect(msg.headers['x-split-total']).toBe('3');
}
});
});describe('Aggregator - Collect Item Results', () => {
it('aggregates individual item results into batch response', async () => {
const batchId = 'BATCH-002';
const itemResults = [
{ sku: 'A1', status: 'PICKED', batchId },
{ sku: 'B2', status: 'PICKED', batchId },
{ sku: 'C3', status: 'PICKED', batchId }
];
for (const result of itemResults) {
await broker.publish('items.completed', {
headers: { 'x-batch-id': batchId, 'x-split-total': '3' },
body: result
});
}
const aggregated = await broker.consume('orders.batch.completed', { timeout: 10000 });
expect(aggregated.body.batchId).toBe('BATCH-002');
expect(aggregated.body.items).toHaveLength(3);
expect(aggregated.body.items.every(i => i.status === 'PICKED')).toBe(true);
});
it('handles aggregation timeout for incomplete batches', async () => {
const batchId = 'BATCH-TIMEOUT';
// Only send 2 of 3 expected items
for (let i = 0; i < 2; i++) {
await broker.publish('items.completed', {
headers: { 'x-batch-id': batchId, 'x-split-total': '3' },
body: { sku: `ITEM-${i}`, status: 'PICKED', batchId }
});
}
// After timeout, aggregator should emit partial result with error
const partial = await broker.consume('orders.batch.incomplete', { timeout: 60000 });
expect(partial.body.batchId).toBe('BATCH-TIMEOUT');
expect(partial.body.receivedCount).toBe(2);
expect(partial.body.expectedCount).toBe(3);
});
});describe('Content Enricher - Customer Data Lookup', () => {
it('enriches order with customer details from CRM', async () => {
mockCrm.onGet('/customers/CUST-50').reply(200, {
name: 'Acme Corp',
tier: 'GOLD',
creditLimit: 50000
});
await broker.publish('orders.enrich', {
body: { orderId: 'ORD-ENRICH', customerId: 'CUST-50', total: 1200 }
});
const enriched = await broker.consume('orders.enriched', { timeout: 5000 });
expect(enriched.body.orderId).toBe('ORD-ENRICH');
expect(enriched.body.customer.name).toBe('Acme Corp');
expect(enriched.body.customer.tier).toBe('GOLD');
expect(enriched.body.creditCheckPassed).toBe(true); // 1200 < 50000
});
});describe('Retry with Exponential Backoff', () => {
it('retries 3 times with increasing delays before DLQ', async () => {
const timestamps = [];
mockEndpoint.onPost('/process').reply(() => {
timestamps.push(Date.now());
return [500, 'Temporary failure'];
});
await broker.publish('orders.process', { body: { orderId: 'ORD-RETRY' } });
await broker.consume('orders.dlq', { timeout: 60000 });
// Verify exponential backoff timing (1s, 2s, 4s approximately)
expect(timestamps).toHaveLength(4); // 1 initial + 3 retries
const delay1 = timestamps[1] - timestamps[0];
const delay2 = timestamps[2] - timestamps[1];
expect(delay1).toBeGreaterThan(800); // ~1s
expect(delay2).toBeGreaterThan(1800); // ~2s
});
});
describe('Circuit Breaker', () => {
it('opens circuit after threshold failures', async () => {
// Fail 5 messages to trip circuit breaker (threshold = 5)
mockEndpoint.onPost('/process').reply(500, 'Down');
for (let i = 0; i < 5; i++) {
await broker.publish('orders.circuit', { body: { orderId: `ORD-CB-${i}` } });
}
// Wait for circuit to open
await sleep(5000);
// Next message should be immediately rejected (circuit open)
const startTime = Date.now();
await broker.publish('orders.circuit', { body: { orderId: 'ORD-CB-FAST-FAIL' } });
const dlq = await broker.consume('orders.circuit.dlq', { timeout: 3000 });
const elapsed = Date.now() - startTime;
expect(dlq.headers['x-circuit-state']).toBe('OPEN');
expect(elapsed).toBeLessThan(2000); // Fast fail, no retry
});
});describe('Service Virtualization - Middleware Isolation', () => {
let virtualService;
beforeAll(async () => {
virtualService = await mountebank.createImposter({
port: 4545,
protocol: 'http',
stubs: [
{
predicates: [{ equals: { method: 'POST', path: '/sap/orders' } }],
responses: [{
is: {
statusCode: 200,
headers: { 'Content-Type': 'application/xml' },
body: '<OrderResponse><Status>CREATED</Status><SapOrderId>SAP-001</SapOrderId></OrderResponse>'
}
}]
},
{
predicates: [{ equals: { method: 'POST', path: '/sap/orders' },
contains: { body: '<InvalidField>' } }],
responses: [{
is: { statusCode: 400, body: '<Error>Invalid request</Error>' }
}]
}
]
});
});
afterAll(async () => {
await mountebank.deleteImposter(4545);
});
it('middleware correctly handles SAP success response', async () => {
await broker.publish('orders.to-sap', {
body: { orderId: 'ORD-VIRT', customer: 'CUST-01' }
});
const result = await broker.consume('orders.sap-confirmed', { timeout: 5000 });
expect(result.body.sapOrderId).toBe('SAP-001');
});
});// Validate middleware routing rules
await Task("Middleware Routing Validation", {
routingConfig: 'esb/routing-rules.xml',
messageTypes: ['STANDARD_ORDER', 'EXPRESS_ORDER', 'RETURN'],
validateDLQ: true,
checkCorrelationIds: true
}, "qe-middleware-validator");
// Test message broker behavior
await Task("Message Broker DLQ Test", {
broker: 'rabbitmq',
queues: ['orders.inbound', 'orders.process', 'orders.dlq'],
retryPolicy: { maxRetries: 3, backoff: 'exponential' },
poisonMessages: ['malformed-xml', 'missing-required-fields', 'oversized-payload']
}, "qe-message-broker-tester");
// SOAP/WSDL contract validation
await Task("SOAP Service Contract Validation", {
wsdl: 'services/OrderService.wsdl',
endpoints: ['CreateOrder', 'GetOrderStatus', 'CancelOrder'],
validateWsSecurity: true,
testFaultHandling: true
}, "qe-soap-tester");
// Transformation accuracy testing
await Task("Transformation Accuracy Suite", {
transformations: [
{ name: 'JSON-to-SAP-XML', input: 'testdata/order.json', expected: 'testdata/order-sap.xml' },
{ name: 'Flat-to-XML', input: 'testdata/inventory.dat', expected: 'testdata/inventory.xml' }
],
validateSchemas: true,
edgeCases: ['empty-fields', 'special-chars', 'max-length']
}, "qe-middleware-validator");aqe/middleware-testing/
routing/ - Routing rule configurations and test results
transformations/ - Mapping definitions and validation results
dlq/ - DLQ test results and replay outcomes
eip-patterns/ - EIP pattern test coverage
circuit-breakers/ - Circuit breaker state and threshold configs
correlation/ - Correlation ID tracing resultsconst middlewareFleet = await FleetManager.coordinate({
strategy: 'middleware-testing',
agents: [
'qe-middleware-validator', // Routing, transformation, EIP patterns
'qe-message-broker-tester', // DLQ, ordering, retry, circuit breaker
'qe-soap-tester' // SOAP contracts, WS-Security, mediation
],
topology: 'mesh'
});
await middlewareFleet.execute({
flows: [
{ name: 'order-inbound', stages: ['route', 'transform', 'enrich', 'deliver'] },
{ name: 'payment-processing', stages: ['validate', 'authorize', 'settle'] }
],
testDLQ: true,
testCompensation: true
});Middleware is the nervous system of enterprise architecture. When it works, nobody notices. When it fails, everything breaks. Test the routing decisions, the transformations, the error channels, and the compensation patterns. Always validate with correlation IDs across multi-hop flows, and always confirm that poison messages end up in the DLQ with enough metadata to diagnose and replay.
With Agents: Agents validate routing rules against message types, test transformation accuracy with schema compliance, and exercise DLQ/retry/circuit-breaker behavior systematically. Use agents to cover the combinatorial explosion of routing paths and transformation edge cases that manual testing cannot reach.
© proffesor-for-testing, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 3 other files (scripts) in assets/skills/middleware-testing-patterns of proffesor-for-testing/agentic-qe.
Open the folder on GitHubat commit 829d030
Middleware Testing Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Middleware Testing Patterns this skillproffesor-for-testing/agentic-qe | 494 | — | ~7k | Automated safety check: Pass | MIT | |
| Testing Best Practicesanonaddy/anonaddy | 4.9k | 5 repos | ~1k | Automated safety check: Pass | MIT | |
| New Event Sourceaws/aws-lambda-dotnet | 1.7k | — | ~3k | Automated safety check: Pass | Apache-2.0 | |
| Nestjs Expertdavila7/claude-code-templates | 32k | 6 repos | ~5.3k | Automated safety check: Notes | MIT | |
| 133 Java Testing Acceptance Testsjabrena/plinth | 445 | — | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Integration Test GeneratorArabelaTso/Skills-4-SE | 253 | — | ~2.1k | Automated safety check: Pass | Apache-2.0 |
anonaddy/anonaddy
Laravel test design and review. An agent skill from anonaddy/anonaddy.
aws/aws-lambda-dotnet
Add a new AWS event source attribute (e.g., Kinesis, Kafka, MQ) to the Lambda .NET Annotations framework, including the attribute class, source generator integration, CloudFormation writer, unit…
davila7/claude-code-templates
Nest.js framework expert specializing in module architecture, dependency injection, middleware, guards, interceptors, testing with Jest/Supertest, TypeORM/Mongoose integration, and Passport.js…
jabrena/plinth
A skill your agent uses when you need to implement acceptance tests from maintainer-sanitized Gherkin scenario facts for framework-agnostic Java (no Spring Boot, Quarkus, Micronaut) — confirming…
ArabelaTso/Skills-4-SE
Generate integration tests for multiple interacting components in Python.
Kilo-Org/kilo-marketplace
Guides development and usage of I/O connectors in Apache Beam.
proffesor-for-testing/agentic-qe
Consumer-driven contract testing for microservices using Pact, schema validation, API versioning, and backward compatibility testing.
proffesor-for-testing/agentic-qe
Test quality validation through mutation testing, assessing test suite effectiveness by introducing code mutations and measuring kill rate.
proffesor-for-testing/agentic-qe
Profiles application performance under load using k6, Artillery, or JMeter to measure latency, throughput, and error rates.
proffesor-for-testing/agentic-qe
Conduct context-driven code reviews focusing on quality, testability, and maintainability.
proffesor-for-testing/agentic-qe
Scans for security vulnerabilities including XSS, SQL injection, CSRF, and auth flaws using OWASP Top 10 methodology.
proffesor-for-testing/agentic-qe
Database schema validation, data integrity testing, migration testing, transaction isolation, and query performance.
Categories
Enterprise middleware testing patterns for message routing, transformation, DLQ, protocol mediation, ESB error handling, and EIP patterns. Middleware Testing Patterns is an agent skill from proffesor-for-testing/agentic-qe. Enterprise middleware testing patterns for message routing, transformation, DLQ, protocol mediation, ESB error handling, and EIP patterns.
Middleware Testing Patterns fits situations like: testing middleware layers; message brokers; integration buses.
Run `npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a claude-code`. Or copy the skill folder (assets/skills/middleware-testing-patterns in proffesor-for-testing/agentic-qe) into .claude/skills/middleware-testing-patterns in your project. Claude Code loads it when a task matches its description.
Run `npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a codex`. Or copy the skill folder (assets/skills/middleware-testing-patterns in proffesor-for-testing/agentic-qe) into .agents/skills/middleware-testing-patterns in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add proffesor-for-testing/agentic-qe --skill middleware-testing-patterns -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/middleware-testing-patterns, .gemini/skills/middleware-testing-patterns, .github/skills/middleware-testing-patterns and .opencode/skills/middleware-testing-patterns in your project.
SKILL.md names no scripts, command-line tools or credentials: Middleware Testing Patterns is instructions for the agent only.
SKILL.md names 1 domain. In commands or code: schemas.xmlsoap.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Middleware Testing Patterns is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 7k tokens (SKILL.md is roughly 28k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Middleware Testing Patterns: Testing Best Practices (anonaddy/anonaddy, 4.9k stars), New Event Source (aws/aws-lambda-dotnet, 1.7k stars), Nestjs Expert (davila7/claude-code-templates, 32k stars) and 133 Java Testing Acceptance Tests (jabrena/plinth, 445 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
proffesor-for-testing (a GitHub user) maintains it in proffesor-for-testing/agentic-qe, which has 494 GitHub stars. The repository holds 111 skills in this directory. The repository was last updated on October 4, 2026.
Source: proffesor-for-testing/agentic-qe on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.