> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/getting-started/quickstart.md).
# Quickstart
### Create, Run, and Review Your First Automated Test
#### Create, Automate, and Run Your First Test
This quickstart walks you through the core TestFirst workflow — from defining what to test to creating and running your first automated test with Agentic Automation.
Before you begin, you’ll need a TestFirst account.
[Sign up](https://www.testfirst.com/plans) using your email or Google account. Once you’re signed in, you can start testing immediately.
### What You’ll Achieve
By the end of this guide, you will have:
* Created a **Test Scope**
* Generated **AI-assisted test cases**
* Created and validated **automation** with the **TestFirst Agent**
* Run an **automated test**
* Viewed the test results
### The Big Picture
```
Requirement / Product Context
↓
Test Scope
↓
AI-generated Test Cases
↓
Agentic Automation ← AI Memory
↓
Run Test
↓
View Results
```
### Step 1: Create Your First Test Scope
A Test Scope defines what you want to test, such as a feature, module, or release.
1. Open Test Scopes from the sidebar.
2. Click + **New Test Scope**.
3. Enter a scope title (optional). If left empty, TestFirst generates one automatically.
4. **Upload** a requirement, specification, test file, or other relevant product context.
5. Supported file types include **plain text, Markdown, DOCX, PDF, CSV, Excel (.xlsx), and source code (.ts, .js, .java, .cs, .py).**
6. You can also use the demo file to get started.
7. Click **Create**.
💡 Product context contributes to AI Memory, TestFirst’s evolving understanding of your product.
***
### Step 2: Generate Test Cases
TestFirst uses your uploaded product context to generate draft test cases.
1. Click **Generate Test Cases**.
2. Wait while TestFirst analyzes the uploaded content.
3. Review the generated test cases.
4. Select the tests you want to include.
5. Click **Add**.
TestFirst may also recommend **relevant existing tests from your Test Case Library**.
***
### Step 3: Automate with the TestFirst Agent
Open one of your generated test cases in the TestFirst Editor and use Agentic Automation to turn the test intent into working automation.
1. From the Test Scope, click the :pencil: (Edit) icon on a test case.
2. In the TestFirst Editor, click 
3. The Test Scope associated with the test case is automatically selected, giving the agent access to its source documents.
4. Use Additional context to give the agent any guidance or instructions for the test.
5. Click **START**.
**Guide the Agent**
Use Additional context to tell the agent anything else it should know or what you want it to do.
For example:
* Provide specific testing instructions
* Ask it to explore a particular flow or scenario
* Provide test data or credentials
* Specify behaviours or conditions to validate
* Direct it to focus on a particular area of the application
{% hint style="success" icon="dot" %}
💡 Additional context is optional. If the test case and selected Test Scope provide enough information, you can start the agent without adding further instructions.
{% endhint %}
The TestFirst Agent uses the **test case, Test Scope, your guidance, and AI Memory** to **understand the intended workflow**. It then **explores** the application, **builds** the automation, and **runs** it to validate the result.
Keep the Editor open and follow the agent from the Preview panel while it works:
```
Explore
↓
Generate
↓
Validate
↓
Review
```
{% hint style="success" icon="dot" %}
💡 As the agent explores your application, it uses and expands AI Memory, building product knowledge that can support future automation.
{% endhint %}
**Review the Automation**
When Agentic Automation is complete:
1. Review the generated test steps and result.
2. Click Accept to add the generated steps to the test case.
3. Set the test case status to Ready for Testing.
4. Save the test case.
Your automated test is now ready.
{% hint style="info" %}
Want more control?
Refine the generated automation using the [Recorder](/testfirst-editor/writing-test-cases/record-test-cases.md) or [edit the Gherkin directly](/testfirst-editor/writing-test-cases/write-test-cases-with-gherkin.md) in the TestFirst Editor.
{% endhint %}
***
### Step 4: Run the Test
Return to your Test Scope:
1. Refresh the page and click **Run Test**.
2. Select the test cases to execute.
3. Click Run.
TestFirst creates a Test Run, sends it for execution, and displays it under Last Test Runs.
***
### Step 5: View Test Results
Click the **Test Run** link from your Test Scope to view the results.
From there, you can:
* See pass/fail status
* Review execution details
* View screenshots and logs
* Generate reports
***
### You’re Done! 🎉
You’ve completed the core TestFirst workflow:
```
Product context → Test design → Agentic Automation → Execution → Results
```
Your automated test can now be edited, refined, reused, and included in future test runs.
#### What to Do Next
* Learn more about Agentic Test Automation
* Understand how AI Memory builds product understanding
* Explore the [TestFirst Editor](/testfirst-editor/editor-overview.md)
* Organize reusable tests in the [Test Case Library](/test-case-library/test-case-library.md)