Platform / Spec2RunAI / User guide / Managing test cases

Spec2RunAI user guide · updated 22 October 2026

Managing test cases

Test cases can come from two places, and both appear in Test Executor side by side.

SourceWhere it livesHow you get them
Core productGenerated from requirements and user stories in the wider platformBrowse Project Tree
Test Executor repositoryTest Executor's own storeTest Cases page — author or import

The two are independent. Adding test cases to the Test Executor repository changes nothing about the ones generated in the core product, and you can run both in the same execution.

Authoring a test case

  1. Go to Test Cases and pick a project, or create one with + New project.
  2. Pick a folder, or create one. Folders group related tests — Account Creation, Checkout, Smoke.
  3. Click + New test case.
  4. Give it a name. Leave the ID blank and it is numbered for you (TC-001, TC-002…).
  5. Add your steps. Each step has an action and an optional expected result. Use the arrows to reorder.
  6. Fill in the overall expected result — this one is required.
  7. Create test case.
Why the overall expected result is mandatory It is what the AI evaluates at the end of the run. Leave it empty and the final check is skipped entirely — the test case then passes as long as no individual step throws, which looks green while proving nothing.

Importing from a spreadsheet

If you already keep manual test cases in Excel, import them rather than retyping. Select a folder and use Import test cases from a spreadsheet.

The layout is one row per step, grouped by Test Case ID:

Test Case IDNamePriorityStep #ActionExpected ResultOverall Expected Result
TC-101Browse the collectionP11Click 'Shop the Collection'The shop page opensThe shop page is displayed with products visible
TC-1012Verify the 'Roaster's Choice Box' card is shownThe card is visible

Name, Priority, Overall Expected Result and Preconditions are read from the first row of each group — leave them blank on subsequent rows. Use Download template for a working example.

Column names are matched leniently: case, spacing and common synonyms (TC ID, Title, Test Step, Acceptance Criteria) all work. You do not need to rename anything.

Before anything is written, the preview tells you what will import, what will be skipped and why (with row numbers), and which IDs already exist and would be overwritten.

Exporting

Export to Excel produces a file in exactly the same layout. That makes bulk editing easy: export, edit fifty test cases in Excel, import back over the top. Re-importing an ID that already exists replaces it.

Try it on your own tests

Ten test cases. Untouched. We run them and send the evidence report.