# qa-__SLUG__

> Build, launch, and verify __APP_DISPLAY__ in the menu bar after a change. Confirms the running build is the one you just built.

- Skill: `iannuttall/qa-slug` (Agent Skill)
- Install (CLI): `npx skillmds@latest add iannuttall/qa-slug`
- Raw SKILL.md: https://api.skillmd.com/api/skills/iannuttall/qa-slug/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: iannuttall (https://skillmd.com/u/iannuttall)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/iannuttall/qa-slug

---


# QA __APP_DISPLAY__

Use this to verify a change actually works in the real app.

## Loop

1. `make check` — format + lint + test. Fix everything it reports before going further.
2. Relaunch cleanly so you never validate a stale build:
   ```
   pkill -x __APP__ || pkill -f __APP__.app || true
   macos dev __SLUG__
   ```
3. Confirm the build you're looking at is the one you just built:
   ```
   pgrep -af "__APP__.app/Contents/MacOS/__APP__"
   ```
4. Verify behavior:
   - The status item appears in the menu bar; clicking it opens the menu.
   - The menu rows reflect the current `AppStatus` (cross-check with `swift run __app__cli`).
   - Settings opens (menu → Settings, or ⌘,) and prefs persist across relaunch.

## Rules

- **Never trigger Keychain prompts.** Credentials use file storage in DEBUG. Keep
  `KeychainPromptSafetyAuditTests` green.
- If a test needs live network or a TTY, gate it behind an env var; don't make it run by default.
- Report what you observed (menu contents, log lines), not just "it works".