> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simpleuat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create and organize tests

> Create suites and cases, use module and tags, and deprecate tests you no longer run.

You organize like a good workbook: tabs (suites), area column (module), labels (tags). You do not get nested suite folders from the create-suite list (`parent_suite_id` stays null).

<Steps>
  <Step title="Create suite">
    **Test Suites** to **Create suite**. One concern per suite when you can.
  </Step>

  <Step title="Add cases">
    **Add First Case** / add more. Prefer `active` only for what you'll run this cycle. `draft` = still writing. `deprecated` = leftover from a pack or last year, keep for history but don't select into the cycle.
  </Step>

  <Step title="Module and tags">
    Module = "Payments" / "Search". Tags = `smoke`, `mobile`, client name: whatever you'll filter on.
  </Step>

  <Step title="Persona and time">
    `required_persona_id` and `estimated_duration_minutes` help assignments and quoting. Optional, useful on bigger jobs.
  </Step>
</Steps>

Pick cycle `case_ids` deliberately. Installing a thorough pack then selecting all will make the cycle too large. Uncheck on install, or deselect in the cycle.

<Columns cols={2}>
  <Card title="Install a pack instead" icon="package" href="/packs/install">
    Then edit the copies.
  </Card>

  <Card title="Import a sheet" icon="upload" href="/imports/bring-existing">
    When the client already wrote the cases.
  </Card>
</Columns>
