Scenario Testing

Run end-to-end scenario tests against real dependencies without mocks.

28|1|Updated Aug 30, 2025
One-click install
npx skills add https://github.com/outfitter-dev/agents --skill scenario-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Scenario Testing
Source: https://github.com/outfitter-dev/agents/tree/main/baselayer/skills/scenario-testing
Command: npx skills add https://github.com/outfitter-dev/agents --skill scenario-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

End-to-end validation using real dependencies, no mocks, ensuring true behavior across services.

Core Features & Use Cases

  • End-to-end validation: test across service boundaries without mocks
  • Scenarios repository: scenarios.jsonl with committed patterns
  • Scratch workspace: .scratch/ for ad-hoc tests

Quick Start

Add a new scenario to scenarios.jsonl and run tests against real dependencies in .scratch/.

Frequently Asked Questions about Scenario Testing

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

FAQPage Schema
How do I write end-to-end tests without mocks?

End-to-end testing without mocks validates your application against real dependencies—actual databases, APIs, and services—rather than stubbed replacements. This approach catches integration failures that mocks hide. Write scenarios in scenarios.jsonl with real service calls, then execute tests in the .scratch/ directory against live systems.

Can I test API contracts and authentication flows in integration tests?

Yes. Scenario testing covers API contract verification and authentication flow validation by running tests against real services. Your scenarios capture actual request-response patterns and credential handling, ensuring contracts hold and auth logic works end-to-end without simulation.

What's the difference between scenario testing and mocked unit tests?

Scenario testing runs against real databases, APIs, and services to validate true cross-service behavior; mocked tests isolate components with fake dependencies and miss integration failures. Scenario testing trades setup overhead for genuine confidence that your system works as deployed.

How do I organize ad-hoc tests and patterns for end-to-end validation?

Use the .scratch/ directory for throwaway scripts and temporary test runs. Commit successful patterns to scenarios.jsonl as reusable test cases. This workflow lets you experiment rapidly while building a repository of validated scenarios for regression testing.

Do I need a real database to run end-to-end tests?

Yes. Scenario testing enforces testing against real databases, not in-memory or mocked versions. This ensures your tests validate actual schema, performance, and data behavior rather than idealized mock responses.

When should I use scenario testing instead of integration testing frameworks?

Use scenario testing when you need genuine end-to-end validation across service boundaries with zero mocks—proof programs, real-world workflows, and multi-service features. It suits teams prioritizing true behavior over test speed and willing to manage live test environments.