client-application-testing
Registry Trigger
Use when
- Changed installed-client behavior needs proof across application lifecycle, operating-system integration, installation state, device configuration, or accessibility settings.
Do not use when
- The work is a pure backend, API-contract, component-only browser, or general test-portfolio decision without an installed-client risk.
Skill Role
Select client-specific interruption paths, application artifacts, environment dimensions, observable oracles, and cleanup. Exclude general test strategy, release verdicts, platform API instructions, and accessibility conformance decisions.
High-Value Rules
- Derive the matrix from the changed client risk. Retain only lifecycle, integration, environment, and artifact dimensions that can alter the accepted behavior.
- Match the test boundary to the failure mechanism. Keep pure policy tests local while exercising operating-system lifecycle, activation, packaging, and resource pressure in a capable client environment.
- Separate background and return, UI recreation, process termination and relaunch, crash recovery, and low-memory response into distinct interruption paths.
- Exercise permission loss as a state transition. Cover initial denial, later grant, revocation while inactive, process termination where applicable, and recovery without stale authority.
- Test every external entry from cold and warm state. Validate deep links and notifications for duplicate delivery, malformed input, wrong account, unavailable content, and existing-instance activation.
- Verify storage across artifact transitions. Test fresh install, upgrade, incompatible data, logout, account switch, and uninstall against the intended preserve, migrate, or clear behavior.
- Select environment dimensions explicitly. Name supported device class, operating-system version, architecture, locale, timezone, font scale, assistive technology, and memory class instead of claiming an unbounded matrix.
- Assert user outcomes and durable effects. Reset application, server, clock, network, permission, notification, and device state so a passing rerun cannot inherit success.
Anti-Patterns
- Treat activity or window recreation as proof of full process death and relaunch.
- Promote one simulator, emulator, architecture, or debug build to the supported client matrix.
- Use screenshots or automation-tree presence as the sole oracle for interaction or assistive-technology behavior.
Stop Conditions
Stop when the supported client matrix, install artifact, required operating-system control, or cleanup authority is unavailable. Report skipped hardware, versions, accessibility checks, and destructive install states rather than converting them to passes.
Output Contract
- client-test decision with risk matrix interruption and activation cases permission and connectivity transitions artifact and data states environment coverage oracles cleanup unavailable scope and proof limits
Targeted References
| Path |
Type |
Load when |
Do not load when |
Required by |
Required output |
| client test matrix |
targeted |
Lifecycle permission activation upgrade device locale scaling assistive-technology or resource-pressure coverage spans several dimensions |
One local test already exercises the complete changed client failure mechanism |
analysis-agent, task-agent, review-agent |
validation-plan, residual-risk |
1---2name: client-application-testing3description: `analysis-agent`/`task-agent`/`review-agent`: use for installed-client lifecycle, permissions, activation, installation, device, or accessibility tests; skip general quality work.4---5
6# client-application-testing
7
8## Registry Trigger
9
10**Use when**
11
12- Changed installed-client behavior needs proof across application lifecycle, operating-system integration, installation state, device configuration, or accessibility settings.
13
14**Do not use when**
15
16- The work is a pure backend, API-contract, component-only browser, or general test-portfolio decision without an installed-client risk.
17
18## Skill Role
19
20Select client-specific interruption paths, application artifacts, environment dimensions, observable oracles, and cleanup. Exclude general test strategy, release verdicts, platform API instructions, and accessibility conformance decisions.
21
22## High-Value Rules
23
24- **Derive the matrix from the changed client risk.** Retain only lifecycle, integration, environment, and artifact dimensions that can alter the accepted behavior.
25- **Match the test boundary to the failure mechanism.** Keep pure policy tests local while exercising operating-system lifecycle, activation, packaging, and resource pressure in a capable client environment.
26- **Separate background and return, UI recreation, process termination and relaunch, crash recovery, and low-memory response into distinct interruption paths.**
27- **Exercise permission loss as a state transition.** Cover initial denial, later grant, revocation while inactive, process termination where applicable, and recovery without stale authority.
28- **Test every external entry from cold and warm state.** Validate deep links and notifications for duplicate delivery, malformed input, wrong account, unavailable content, and existing-instance activation.
29- **Verify storage across artifact transitions.** Test fresh install, upgrade, incompatible data, logout, account switch, and uninstall against the intended preserve, migrate, or clear behavior.
30- **Select environment dimensions explicitly.** Name supported device class, operating-system version, architecture, locale, timezone, font scale, assistive technology, and memory class instead of claiming an unbounded matrix.
31- **Assert user outcomes and durable effects.** Reset application, server, clock, network, permission, notification, and device state so a passing rerun cannot inherit success.
32
33## Anti-Patterns
34
35- Treat activity or window recreation as proof of full process death and relaunch.
36- Promote one simulator, emulator, architecture, or debug build to the supported client matrix.
37- Use screenshots or automation-tree presence as the sole oracle for interaction or assistive-technology behavior.
38
39## Stop Conditions
40
41Stop when the supported client matrix, install artifact, required operating-system control, or cleanup authority is unavailable. Report skipped hardware, versions, accessibility checks, and destructive install states rather than converting them to passes.
42
43## Output Contract
44
45- client-test decision with risk matrix interruption and activation cases permission and connectivity transitions artifact and data states environment coverage oracles cleanup unavailable scope and proof limits
46
47## Targeted References
48
49| Path | Type | Load when | Do not load when | Required by | Required output |
50|---|---|---|---|---|---|
51| [client test matrix](references/client-test-matrix.md) | targeted | Lifecycle permission activation upgrade device locale scaling assistive-technology or resource-pressure coverage spans several dimensions | One local test already exercises the complete changed client failure mechanism | analysis-agent, task-agent, review-agent | validation-plan, residual-risk |