defining-test-scenarios

Expand behavioral spec features into deterministic GIVEN-WHEN-THEN test scenarios.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/pipemind-com/pipemind-marketplace --skill defining-test-scenarios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: defining-test-scenarios
Source: https://github.com/pipemind-com/pipemind-marketplace/tree/main/plugins/spec-driven-development/skills/defining-test-scenarios
Command: npx skills add https://github.com/pipemind-com/pipemind-marketplace --skill defining-test-scenarios

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill converts ambiguous or high-level behavioral specifications into unambiguous, granular test scenarios so downstream test-writing agents can generate executable tests without making behavioral decisions. It bridges the gap between "what the system should do" and a deterministic set of observable acceptance checks.

Core Features & Use Cases

  • Spec expansion: Expand a single feature ID from a behavioral spec into a suite of GIVEN / WHEN / THEN scenarios scoped to that feature.
  • Constraint enforcement: Enforce strict rules (no code, no architecture assumptions, observable outcomes only) and deterministic entity labeling to ensure scenarios are implementation-agnostic.
  • Assumption & cross-feature handling: Flag and encode [ASSUMPTION] behaviors, include cross-feature traceability notes, and produce a Coverage Summary for traceability.
  • Use Case: QA Architects preparing acceptance criteria for an autonomous test-writing agent that will generate end-to-end or unit tests from the produced scenarios.

Quick Start

Expand feature F-05 in specs/enrollment.md into a complete specs/enrollment.test.F05.md file containing precise GIVEN / WHEN / THEN scenarios and a Coverage Summary.

Frequently Asked Questions about defining-test-scenarios

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

FAQPage Schema
How do I generate test scenarios from behavioral specs for autonomous agents?

To generate test scenarios from behavioral specs, expand a single feature ID into deterministic GIVEN-WHEN-THEN scenarios. This approach ensures downstream test-writing agents receive unambiguous acceptance checks without making behavioral decisions.

What is the best way to write deterministic GIVEN-WHEN-THEN tests from a feature spec?

The best way to write deterministic GIVEN-WHEN-THEN tests is to enforce observable outcomes only and use deterministic entity placeholders. This guarantees scenarios remain implementation-agnostic and strictly scoped to the feature ID.

How do I ensure generated test scenarios are implementation-agnostic?

To ensure generated test scenarios are implementation-agnostic, enforce constraints like no source-code reading and no architecture assumptions. Scenarios must only specify observable outcomes and deterministic entity labeling.

Can I expand a single feature ID from a spec file into a complete test suite?

Yes, you can expand a single feature ID from a behavioral spec into a complete test suite. The process produces a dedicated specs/{spec-name}.test.{FXX}.md file containing precise scenarios and a Coverage Summary for traceability.

How do I handle assumptions and cross-feature traceability in test generation?

To handle assumptions and cross-feature traceability in test generation, flag and encode [ASSUMPTION] behaviors directly within the scenarios. Additionally, include cross-feature traceability notes and produce a Coverage Summary.

Does spec-driven test generation work without reading the underlying source code?

Yes, spec-driven test generation works without reading source code. It bridges the gap between system behavior and acceptance checks by enforcing non-code constraints, relying exclusively on observable outcomes from the behavioral spec.