{{ result.summary.title }}
{{ result.summary.primary }}
{{ result.summary.line }}
{{ badge.label }}
Arrange Act Assert {{ testCaseFlowStage.caseLabel }}
Test case generator inputs
Use the ticket title, requirement name, or product flow reviewers will recognize.
Traceable IDs make generated cases easier to keep current after changes.
Choose the closest execution surface before writing the steps.
Use the priority your test management tool expects.
Avoid vague goals such as works correctly; describe the behavior to verify.
One verifiable starting condition per line keeps false failures out of the case.
Concrete values make the generated case executable instead of only conceptual.
Each line becomes a numbered execution step in the primary case.
Rows stay local and recompute instantly.
Make the pass condition explicit enough to compare against the actual result.
Use this for cleanup and resulting system state, not for extra action steps.
Each line becomes a focused secondary test case.
Manual works for test management tools; Gherkin works for BDD handoff; automation notes help engineers script the cases.
Use a project or tracker prefix, for example TC, PAY, API, or EXP.
Useful when appending cases to an existing suite.
Off keeps the generated pack limited to the supplied happy path and negative cases.
{{ include_quality_cases ? 'On' : 'Off' }}
{{ result.casePack }}
ID Type Priority Objective Steps Expected result Copy
{{ row.id }} {{ row.type }} {{ row.priority }} {{ row.objective }} {{ row.stepCount }} step{{ row.stepCount === 1 ? '' : 's' }} {{ row.expected }}
Case matrix is waiting for required inputs
Complete the feature, objective, steps, and expected result to generate executable case rows.
Review point Status Evidence Next action Copy
{{ row.point }} {{ row.status }} {{ row.evidence }} {{ row.action }}
Customize
Advanced
:

Introduction

Useful software tests start as small claims about behavior that someone can repeat. A case names the condition being checked, the starting state, the data, the action, and the evidence that proves the behavior matched the source rule.

That evidence is the part many weak cases miss. A tester needs a trusted expected result, often called a test oracle, before a row can produce a meaningful pass or fail decision. The oracle may come from a requirement, API contract, acceptance rule, existing benchmark, support policy, or expert decision. The product code under test should not be its own source of truth.

Case writing also has a coordination job. Product owners read for intent, developers read for behavior boundaries, testers read for repeatability, and release managers read for risk. A row that leaves out the account role, record state, payload, error message, audit event, or cleanup state makes each reader fill in a different version of the same check.

Several terms matter before the format choice does. Manual cases, Gherkin scenarios, and automation handoff notes all depend on the same underlying pieces.

Precondition
A starting state that must be true before execution, such as a permission, record state, environment flag, or existing job.
Test data
Concrete values, accounts, IDs, files, payloads, or fixtures used during the case.
Action step
One tester or system action that moves the case forward and can be repeated by someone else.
Expected result
The observable evidence that lets the tester decide whether the actual result passed.

Manual rows favor exact execution steps. Gherkin expresses examples through Given, When, and Then wording. Automation notes need stable setup, repeatable data, assertions, and cleanup so engineers can turn the idea into scripted checks later. Changing the writing style should not change the behavior claim.

Setup, data, steps, and expected result blocks feeding one test case row

Scope control keeps failures diagnosable. A row that mixes setup investigation, five user goals, and several unrelated expected results may fail without telling the team what broke. A narrow row with one objective makes it easier to separate a product defect from bad setup, wrong data, or a stale expectation.

Coverage is not row count. Boundary and negative cases matter because they exercise limits, invalid states, missing permissions, duplicate actions, timeouts, and recovery behavior that a happy path can hide. They still need a reason tied to real risk, not just a longer checklist.

Case packs should be treated as review material until the team confirms the requirement, oracle, data, and environment. A clean pack can organize the work and expose missing inputs, but it cannot prove that the source rule itself is complete or current.

How to Use This Tool:

Start with the primary behavior, then add the failure paths that would change release confidence. The generated tabs are best used as a review surface before the case pack is copied into a test-management, BDD, or automation-planning workflow.

  1. Enter Feature or requirement and Reference ID. The feature names the pack and rows, while the reference keeps the cases tied to a ticket, risk, release, or requirement.
  2. Choose Test layer and Priority. Use UI behavior, API contract, Workflow handoff, Regression path, or Exploratory charter seed to shape the generated wording.
  3. Write one focused Test objective. Add setup rows in Preconditions and concrete fixtures in Test data so another tester can repeat the path.
  4. Put one action per line in Action steps, then write an Expected result with visible pass evidence. Use Normalize when pasted notes need duplicate cleanup, consistent casing, a bounded start number, or a cleaned case prefix.
  5. Add cleanup or resulting state in Postconditions, then list blocked states, invalid data, permission failures, limits, duplicate actions, timeouts, and retries in Negative and boundary cases.
  6. Choose Case pack format. Manual test cases creates test-management style text, Gherkin scenarios creates feature and scenario wording, and Automation handoff adds setup, data, assertion, and cleanup notes.
  7. Open Advanced for Case ID prefix, Start number, and Add quality coverage cases. Quality coverage adds accessibility and operational-evidence rows when those checks belong in the pack.
  8. Review Case Matrix and Quality Review before using the exports. If required input is missing, the warning panel names the missing field and the pack stays on placeholder text until the field is filled.

Interpreting Results:

Needs input means at least one required field is missing: feature, objective, action steps, or expected result. Review cues means rows were generated, but setup, data, traceability, granularity, negative coverage, or oracle wording still asks for attention. Execution ready means the built-in completeness, coverage, and wording checks are currently passing.

The case count is a coverage clue, not a quality score. Five weak negative rows can still miss the most important permission or recovery behavior. Read Quality Review for the reason behind each status, then inspect the matching rows in Case Matrix before accepting the wording.

Test case output areas and confidence boundaries
Output Use It For Verify Separately
Test Case Pack Readable case text in the selected format Whether the wording matches the real requirement and team vocabulary
Case Matrix IDs, types, priority, objective, step count, and expected result side by side Whether each row covers one useful risk
Quality Review Completeness, setup/data, granularity, oracle, negative coverage, traceability, format, and quality cues Whether the source requirement and oracle are correct and current
JSON A structured snapshot of summary counts, case rows, review rows, and errors Whether it should be shared outside the project team

A passing expected-oracle review only means the wording avoided a short vague-term check. Compare the expected result with the specification, contract, user rule, existing benchmark, or expert judgment before treating the case as executable.

Technical Details:

Testing terminology treats a test case as a set of input values, execution preconditions, expected results, and execution postconditions for a particular objective or test condition. The objective keeps the row narrow, while setup, data, steps, and expected result make the execution repeatable.

The expected result depends on a test oracle: a source that lets the tester compare actual behavior with intended behavior. Useful oracles include specifications, API contracts, user rules, manuals, existing system behavior used as a benchmark, or specialized domain knowledge. The code under test should not be treated as its own source of truth.

Gherkin expresses behavior examples with structured keywords. Given sets the context, When names the event or action, and Then states the expected outcome. Scenario text can support review and later automation, but it still needs reliable data, precise assertions, and agreement that the example reflects the product rule.

Rule Core:

Rules used to construct generated test case rows
Input Cue Generated Row Boundary or Note
Test objective, Action steps, and Expected result One primary row, usually Happy Path, or Exploratory for the exploratory layer Rows are blocked until feature, objective, action steps, and expected result are present.
Each unique Negative and boundary cases line One secondary row classified as Negative, Boundary, Security, Resilience, or Exploratory Security terms such as permission, role, access, auth, forbidden, token, or session become security rows; retry, timeout, transient, network, latency, race, duplicate, 409, 429, 500, or 503 terms become resilience rows.
Add quality coverage cases One Accessibility row and one Observability row These rows are optional and lower a P0 priority to P1 for quality coverage.
Case ID prefix and Start number IDs such as TC-001, with uppercase prefix and three-digit numbering The prefix keeps letters, numbers, underscores, and hyphens; the starting number is bounded from 1 through 999.
Case pack format Manual case text, Gherkin scenarios, or automation handoff text The format changes the written artifact, not the underlying case rows.

Secondary Case Classification:

Keyword families used to classify secondary generated test rows
Condition Cue Row Type Expected Result Pattern
Permission, role, access, authorization, forbidden, token, or session terms Security The action is denied, no unauthorized state change occurs, and the attempt remains traceable.
Timeout, retry, transient, network, latency, race, duplicate, or common failure-code terms Resilience The condition is handled without duplicate side effects, with recovery evidence visible to the tester.
Limit, maximum, minimum, empty, null, invalid, boundary, completed, expired, or retention terms Boundary The system blocks, validates, or safely handles the condition with no unintended state change.
Other supplied edge-case text Negative, or Exploratory when the exploratory layer is selected The row uses the supplied condition and the closest execution language for the selected surface.

Review Rules:

Quality review status rules for generated test cases
Review Point Pass Condition Review or Fail Condition
Core case completeness Feature, objective, action steps, and expected result are present. Any missing required field produces a failure and blocks generated case rows.
Preconditions and data At least one precondition row and one test data row are supplied. Missing either one asks for review.
Step granularity The primary action list has 2 through 12 steps. Zero, one, or more than 12 steps asks for review.
Expected oracle The expected result is present and avoids built-in vague terms. Words such as works, correctly, as expected, successfully, properly, fast, secure, user-friendly, or similar vague terms ask for clearer evidence.
Negative and boundary coverage Two or more negative or boundary cues are supplied. One cue asks for review; zero cues fail this review point.
Traceability A reference ID is supplied. No reference ID asks for review.
Quality coverage Accessibility and operational-evidence rows are included when the quality option is on. When the option is off, the review marks the point optional and keeps the pack focused on supplied cases.

Row generation is deterministic from the current text fields and options. Duplicate line entries are collapsed, common list markers are stripped, case IDs are normalized, and every generated row remains a draft until a human confirms the behavior and oracle.

Worked Examples:

Export Retry Flow:

Use Export retry flow, reference EXP-1842, UI behavior, priority P1, an objective about retrying a failed export, setup rows for admin access and one failed export, and five action steps. Three negative cues such as completed export, removed permission, and transient conflict produce one Happy Path row plus Boundary, Security, or Resilience rows.

Automation Handoff for an API Contract:

Choose API contract and Automation handoff for a token rotation check. Add authorization setup, a concrete payload, expected status and response evidence, and cleanup notes. Missing authorization, expired credential, duplicate request, and rate-limit cues become secondary rows with API-focused assertion notes.

Review-Cue Cleanup:

A pack with one action step, no test data, no reference ID, and an expected result of Works correctly can render, but Quality Review asks for better setup/data, step granularity, traceability, and oracle wording. Add fixture values, split the action into two or more steps, and replace the expected result with a visible state or recorded event.

Blocked Required Input:

If Action steps is empty, the summary shows Needs input and the warning says to add at least one action step. Add one tester action per line, then confirm that Case Matrix now contains generated rows before copying the pack.

FAQ:

Why did the pack create more cases than I typed?

The primary objective creates one main row. Each unique Negative and boundary cases line creates another row, and Add quality coverage cases adds accessibility and observability rows.

Why is Quality Review still showing Review?

Common causes are missing preconditions or test data, one-step action lists, vague expected wording, no negative coverage, or no reference ID.

Can the Gherkin output run as automated tests?

No. It is scenario text. Automation still needs step definitions, stable setup, reliable data, and assertions that compare actual behavior with the expected outcome.

Why did a boundary line become Security or Resilience?

The row type uses keywords in the cue. Permission, role, access, auth, token, or session terms become Security; timeout, retry, network, latency, duplicate, or common failure-code terms become Resilience.

Does typed case text get submitted for processing?

The case pack, matrix, review rows, and JSON are built in the browser from the entered fields. The visible actions copy or download the generated artifacts.

Glossary:

Test case
A repeatable check with an objective, setup, input data, actions, expected result, and resulting state.
Precondition
A state that must be true before execution starts, such as role, environment, record, or configuration.
Postcondition
The state expected after the case runs, including cleanup, audit, data, or workflow effects.
Expected result
The behavior or evidence that should appear if the system satisfies the source rule.
Test oracle
The source used to decide whether actual behavior matches the expected result.
Gherkin scenario
A behavior example written with Given, When, and Then style steps.

References: