Agent Device

Default flow

1. Load references/bootstrap-install.md and references/exploration.md before acting on a normal device task.
2. Use bootstrap first to confirm or establish the correct target, app install, and open app session.
3. Once the app session is open and stable, use exploration for inspection, interaction, and verification.
4. Start with plain snapshot if the goal is to read or verify what is visible.
5. Escalate to snapshot -i only if you need refs for interactive exploration or a requested action.
6. Use get, is, or find before mutating the UI when a read-only command can answer the question.
7. End by capturing proof if needed, then close.

QA modes

• Open-ended bug hunt with reporting: use ../dogfood/SKILL.md.
• Pass/fail QA from acceptance criteria: stay in this skill, start with references/bootstrap-install.md, then use the QA loop in references/exploration.md.

Required references

• For every normal device task, after reading this file, load references/bootstrap-install.md first, then references/exploration.md, before acting.
• Use bootstrap to confirm or establish deterministic setup, especially in sandbox or cloud environments.
• Use exploration once the app session is open and stable.
• Load additional references only when their scope is needed.

Decision rules

• Use plain snapshot when you need to verify whether text is visible.
• Use snapshot -i mainly for interactive exploration and choosing refs.
• Use diff snapshot for compact post-action verification; use snapshot --diff when that alias is easier to discover from snapshot help.
• Use get, is, or find when they can answer the question without changing UI state.
• Use fill to replace text.
• Use type to append text.
• Do not write type @eN "text". Use fill @eN "text" to target a field directly, or press @eN then type "text" when the field already has focus and you want append semantics.
• If the on-screen keyboard blocks the next step, prefer keyboard dismiss over navigation. On iOS, keep an app session open first; keyboard status|get remains Android-only.
• When a task asks to "go back", use plain back for predictable app-owned navigation and reserve back --system for platform back gestures or button semantics.
• Use type --delay-ms or fill --delay-ms for debounced search fields that drop characters when typed too quickly.
• If there is no simulator, no app install, or no open app session yet, switch to bootstrap-install.md instead of improvising setup steps.
• Use the smallest unblock action first when transient UI blocks inspection, but do not navigate, search, or enter new text just to make the UI reveal data unless the user asked for that interaction.
• In React Native dev or debug apps, treat visible warning or error overlays as transient blockers unless the user is explicitly asking you to diagnose them. Dismiss them when safe, then continue the requested flow.
• Do not use external lookups to compensate for missing on-screen data unless the user asked for them.
• If the needed information is not exposed on screen, say that plainly instead of compensating with extra navigation, text entry, or web search.
• Prefer @ref or selector targeting over raw coordinates.

Additional references

• Need logs, network, alerts, permissions, or failure triage: references/debugging.md
• Need screenshots, diff, recording, replay maintenance, or perf data: references/verification.md
• Need desktop surfaces, menu bar behavior, or macOS-specific interaction rules: references/macos-desktop.md
• Need remote HTTP transport, connect --remote-config, or tenant leases on a remote macOS host: references/remote-tenancy.md This includes remote React Native runs where agent-device now prepares Metro locally and manages the local Metro companion tunnel automatically.