Managing flows
Day-to-day operations on your test suite — editing, reorganising, archiving, and creating flows by hand.
Where flows live
Open any app and click the Flows tab. Flows are grouped by category — the same hierarchy you see on the landing page's “Learn the flows” section. Categories are derived from the flow's category field, which can be a path of any depth (e.g. ["Billing", "Subscription", "Upgrade"]).
Editing a flow
Click any flow to open its detail page. From there you can edit:
- Name — the display name in the suite and in reports.
- Category — drag-and-drop into a different group, or rename a group.
- Instructions — the natural-language description used by AI recovery and the verifier.
- Steps — reorder, edit individual selectors, or add/remove steps.
- Assertions — add or remove the AI-evaluated assertions that run after the flow finishes.
Every meaningful edit is logged to the flow's event history so you can see when a step was last changed and why.
Editing steps vs editing instructions
Prefer editing the instructions when something subtle changed (“the welcome message now has a confetti animation, ignore it”). Edit steps directly only when the user journey itself changed — the AI recovery agent is good at adapting to small UI shifts on its own.Reorganising
Use the Reorganise action on the flows page to bulk-move flows between categories. This is most useful after a major refactor when the AI's original grouping no longer matches your mental model.
Creating a flow manually
Click New flow on the flows page and write a description of what you want tested (e.g. “Sign up with email, click the verification link in the inbox, and confirm the dashboard loads”). Qassandra will:
- Open the app and follow your description as an AI agent run.
- Record the steps it took, the selectors it found, and the assertions that confirmed success.
- Save the result as a real flow ready to run on every check.
Archiving and deleting
- Archive — the flow stops being run by checks but is preserved in the UI under Archived flows. Use this when you're unsure whether to remove it.
- Restore — bring an archived flow back into the active suite.
- Delete — permanently removes the flow, its events, and its screenshots. Cannot be undone.
Approving suggestions
Most new flows enter your suite via suggestions on a check report. Approving a suggestion creates a real flow with the discovered steps and instructions; you can edit it like any other flow afterwards.