test-integration

Validate behavior across real integration boundaries with isolated temp roots and deterministic commands.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/JonusNattapong/A2A-MCP --skill test-integration-jonusnattapong
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-integration
Source: https://github.com/JonusNattapong/A2A-MCP/tree/main/src/agenttalk/skills/devkit/test-integration
Command: npx skills add https://github.com/JonusNattapong/A2A-MCP --skill test-integration-jonusnattapong

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Unit tests often miss bugs that live in wiring, serialization, subprocess handling, paths, locks, or persisted state. This Skill validates behavior that only appears when real project boundaries meet, such as CLI plus store, filesystem behavior, config loading, migrations, or process/supervisor interactions, while keeping tests isolated and repeatable. ## Core Features & Use Cases - Real boundary testing: Exercise the actual CLI, store, filesystem, or process path under test instead of mocking the boundary itself. - Isolation discipline: Build temp roots, temp config/home paths, unique ports, and deterministic clocks so tests never touch the operator's live state. - Dual evidence modes: Emit a qa-result profile for executed QA checks or a production-handoff profile when adding or changing production integration tests. - Use Case: After changing how the CLI writes to the message store, run an integration check against a temp store root to prove the CLI-plus-store contract holds, then report the exact command, result, and covered ref as qa-result evidence. ## Quick Start Ask the agent to run an integration test of the CLI and store boundary using an isolated temp root and report the executed command and result as qa-result evidence.

Frequently Asked Questions about test-integration

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

FAQPage Schema
How do I write integration tests for a CLI and its data store?▼

Exercise the real CLI and store path against an isolated temp root with temp config and home paths, then run the narrowest command that proves the boundary contract. Record the exact command, result, and the ref or scope it covers as evidence.

When should I use integration tests instead of unit tests?▼

Use integration tests when the bug risk lives in wiring, serialization, subprocess or environment handling, paths, locks, or persisted state that a unit test would miss. If the target is a pure function or low-level behavior, unit-level coverage is sufficient.

How do I keep integration tests deterministic and isolated?▼

Build isolation before execution: temp roots and stores, temp HOME or config paths, unique ports and files, deterministic clocks, and cleanup. Never point a test at the operator's live store or user config, and avoid unbounded sleeps or live network dependencies.

What should I stub in an integration test?▼

Do not fake the boundary under test; stub only unrelated external services or expensive dependencies, and state that stub explicitly. The real CLI, store, filesystem, or process path being validated must be exercised directly.

When is this integration testing approach not appropriate?▼

It is not suited for pure-function tests, full user journeys requiring unstable sleeps or external services, fixing an already-failing check, product implementation or refactoring work, or reviewing an existing diff.