patrol-tests-architecture
Installation
SKILL.md
Order of actions when writing new tests
- Read the key files directly (modules aggregator, test wrapper, main keys.dart, and the specific app feature files for the scenario). These are known paths — don't search for them, open them directly
- Inspect existing modules for functions that can be reused
- Also think if one of existing functions can be adjusted to match its existing usage and new test
- Assign test keys to required elements if they are not assigned yet
- Start writing test: reuse existing modules/functions + put new test steps in new test file
- Write patrol actions directly in the test file, do not create new methods in modules
- Run the test frequently during development — don't wait until the full test is written. Run after completing each logical group of steps to catch failures early
- After full test passes, reorganize new code into existing/new modules. This is mandatory — the test file must only call module methods, not use Patrol APIs directly
- Rerun the test after reorganizing to confirm it still passes
Patrol MCP Usage
When working with Patrol tests: