# Quick Pane v1 Test Plan and QA Checklist

## Automated coverage

### Settings

- Valid defaults load when no Quick Pane configuration exists.
- Valid configuration round-trips through native storage.
- Invalid workspace, model, prompt, time, and tool values show field errors and retain prior saved state.
- Quick model picker affects quick request only; follow-up model remains configured default.

### Runtime guardrails

- Quick runtime receives immutable advisory read-only/no-subagent prompt text plus supplemental prompt.
- Mutation, subagent, multi-step, and likely-over-budget requests are instructed to preflight-escalate.
- Runtime applies best-effort configured 60-second/6-tool caps from observed events and exposes reason.
- Partial result survives a cap; pane transcript is removed and runtime cleanup requested after pane close.
- Tests/documentation state current limitations: Pi RPC cannot trusted-enforce prompt policy or guarantee memory-only temporary sessions.

### UI and bridge

- Quick Pane opens/focuses through dedicated native command without changing normal `--new` or `--toggle` behavior.
- Workspace and quick-model picker values reach runtime creation.
- Permission and clarification extension requests render inline and send correct response payloads.
- Retry, model change, and normal-session actions appear for startup/model/crash errors.
- Handoff creates normal session with original request, escalation note, workspace, and follow-up model.

## Manual smoke checklist

1. Configure default workspace, models, prompt, and 60-second/6-tool limits.
2. Add desktop/WM hotkey using Settings launch command.
3. From no running GUI process, invoke hotkey and verify Quick Pane opens/focuses.
4. Submit short answer-only request; verify result within 60 seconds.
5. Submit read-only inspection request; answer any external-read permission prompt inline.
6. Submit mutation or multi-step request; verify reason and **Continue in full session**.
7. Continue; verify normal session receives handoff and follow-up model.
8. Close Quick Pane; reopen and verify quick transcript is absent.
9. Select unavailable model or induce startup failure; verify inline recovery options.

## Exit criteria

All targeted automated tests pass. Manual cold-launch/hotkey smoke completes. No regressions in normal sessions, `--toggle`, or `--new` behavior.