integration-testing

Test connected components across databases, caches, queues, and HTTP adapters.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill integration-testing-machenjie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-testing
Source: https://github.com/machenjie/rd-skills/tree/main/src/foundation/capabilities/integration-testing
Command: npx skills add https://github.com/machenjie/rd-skills --skill integration-testing-machenjie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Integration testing ensures that connected system components work correctly together across real infrastructure boundaries, where unit tests and mocks can hide constraint, rollback, and serialization failures.

Core Features & Use Cases

  • Real-boundary validation: Exercises the actual database queries, serialization, auth context, and infrastructure seams under test-container controlled environments.
  • Controlled external dependencies: Uses Testcontainers for infrastructure (PostgreSQL, Redis, Kafka, MongoDB, LocalStack) and WireMock/nock for HTTP dependencies, avoiding flaky shared staging systems.
  • Failure-path correctness: Verifies rollback, timeouts, and partial-write/offset-commit behavior by asserting both persisted state and side effects beyond HTTP success responses.

Quick Start

Use integration-testing when your change crosses a service boundary and you need proof that the real seam behaves correctly for both success and rollback scenarios, with isolated data and deterministic dependencies.

Frequently Asked Questions about integration-testing

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

FAQPage Schema
How do I test database rollback and timeout paths across real infrastructure seams?

To test rollback and timeout paths across real infrastructure seams, use Testcontainers for deterministic databases and assert persistent state alongside emitted side effects beyond standard HTTP success responses.

Why does my integration test pass with mocks but fail on real database serialization and constraints?

Mock-only tests hide constraint, rollback, and serialization failures. Validating connected components across real infrastructure boundaries using Testcontainers ensures actual database queries and serialization behave correctly.

How do I set up deterministic integration testing for external HTTP adapters and queues?

Set up deterministic integration testing by controlling external HTTP adapters with WireMock or nock, and using Testcontainers for queues like Kafka to isolate test data and verify seam behavior.

Can I use Testcontainers and WireMock for controller-service-repository flow testing?

Yes, you can use Testcontainers and WireMock for controller-service-repository flow testing. This approach exercises real database queries, serialization, and auth context under controlled, isolated environments.

What is the best way to verify failure-path correctness and side-effect assertions in integration tests?

The best way to verify failure-path correctness is asserting both persisted state and side effects including rollback, timeouts, and partial-write behavior using deterministic infrastructure via Testcontainers.