scenario-testing

Execute end-to-end scenarios against real dependencies to validate code changes.

90|6|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/2389-research/claude-plugins --skill scenario-testing-2389-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scenario-testing
Source: https://github.com/2389-research/claude-plugins/tree/main/scenario-testing/skills
Command: npx skills add https://github.com/2389-research/claude-plugins --skill scenario-testing-2389-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to validate code changes by running end-to-end scenarios against real dependencies, avoiding reliance on mocks that can mask integration issues.

Core Features & Use Cases

  • Write and manage scenario tests in the .scratch/ directory, exercising real systems end-to-end.
  • Promote recurring patterns to scenarios.jsonl to create documented, reusable specifications.
  • Keep scratch environments out of version control and ensure scenarios run standalone in CI/CD.

Quick Start

Create a scenario in the .scratch/ directory that uses real services, then document the pattern in scenarios.jsonl and run the scenario to validate the feature.

Frequently Asked Questions about scenario-testing

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

FAQPage Schema
How do I run end-to-end scenario tests against real dependencies without mocks?

End-to-end scenario tests execute real services and data by writing scenarios in a .scratch/ directory. This approach enforces no mocks, ensuring integration issues surface during feature validation across local, CI, or staging environments.

How do I manage and promote recurring end-to-end test patterns for reuse?

Recurring end-to-end test patterns are extracted and documented in a scenarios.jsonl file. This creates reusable specifications, allowing development and QA teams to consistently validate code changes independently.

Can I run real end-to-end scenarios in my CI/CD pipeline?

Yes, scenarios are designed to run standalone in CI/CD pipelines. They execute against actual dependencies without mocks, validating features across local, CI, or staging environments while keeping scratch environments out of version control.

Why use real dependencies instead of mocks for feature validation?

Real dependencies avoid the integration issues that mocks can mask. By executing end-to-end scenarios with actual services and data, developers validate code changes against true system behavior rather than simulated responses.

Do I need a specific directory setup to start writing end-to-end scenario tests?

Yes, scenario tests require a .scratch/ directory to write and manage tests exercising real systems. This directory must remain ignored by version control while scenarios run independently across environments.

What are the limitations of using real dependencies for end-to-end testing?

Real end-to-end testing requires actual services and data, demanding the ability to run scenarios independently across local, CI, or staging environments. It may not suit contexts lacking real service access or standalone execution capabilities.