Test Cases

Test Cases

Overview

Test cases define how to verify that a feature or fix works correctly. Each test case describes the steps to follow and the expected outcome. You can link test cases to user stories for full traceability from requirement to verified delivery.

Silverile also integrates with the VS Code extension to generate test scripts automatically from acceptance criteria — see the VS Code Extension guide for details.

Getting there

1Select your project from the project switcher
2Click Test Cases in the left sidebar
3The test case list loads showing all test cases in the project

Creating a test case

1Click Add Test Case at the top of the list
2Fill in the title, steps, and expected result (see field reference below)
3Optionally link to the user story being tested
4Click Save

Test case structure

FieldRequiredNotes
TitleYesShort description of what is being tested.
DescriptionNoContext and background for the test. What system state is assumed.
PreconditionsNoSetup steps required before the test can be executed — e.g. "User must be logged in as Admin".
Test StepsYesNumbered steps to perform the test. Each step should be a single, specific action.
Expected ResultYesWhat should happen if the system behaves correctly after all steps are completed.
Linked StoryNoThe user story or acceptance criterion this test case validates.
PriorityNoHow critical this test is — High, Medium, or Low.
Write test steps at the level of a junior tester who has never seen the feature. Assume nothing — specify every click, input value, and navigation step.

Linking to stories

Linking a test case to a user story gives you full traceability — you can see which acceptance criteria are covered and which stories have no test coverage yet.

Open a story's detail view and go to the Test Cases tab to see all test cases linked to that story, and to add new ones directly from there.

Executing tests

Test cases are executed within a test run — a snapshot of selected test cases at a point in time (e.g. for a sprint or release).

1From the Test Cases list, click New Test Run
2Select the test cases to include — by sprint, story, or manually
3Name the run (e.g. "Sprint 12 Regression") and click Start
4Work through each test case and record the result

Recording results

For each test case in a run, record one of the following outcomes:

ResultWhen to use it
PassThe system behaved exactly as described in the Expected Result.
FailThe system did not match the expected result. A defect should be filed.
BlockedThe test could not be executed due to an environment issue or a dependency.
SkippedThe test was intentionally not run in this cycle.

When a test fails, you can create a defect directly from the test result — click File Defect and the defect form pre-fills with the test case title and steps.

Troubleshooting

I don't see a Test Cases section in the sidebar

Test case management may need to be enabled for your project under Project Settings. Ask your project manager to enable it if it's not visible.

I can't link a test case to a story

Test cases can be linked to stories within the same project. Search for the story by ID or title in the Linked Story field. If the story is in a different project, you can reference it by ID in the description.

Test results aren't being saved

Results are saved per execution run. Make sure you've started a test run before recording results — you can't record a pass/fail directly on a test case without an active run.

A team member can't see the test cases I created

Test cases follow project access controls. Confirm the team member has at least read access to the project. Read-only members can view test cases but cannot create or execute them.

I want to generate test cases from a story automatically

The Silverile VS Code extension can generate test scripts from acceptance criteria. Open VS Code, right-click in a code file, and choose Silverile → Generate Test Scripts from Story, then enter the story ID.