# First-Run Review Notes

Use this file to capture the independent reviewer pass required to close
milestone 4.

## Review summary

- Reviewer: Independent AI review
- Date: 2026-03-12
- Environment: Documentation, checked-in media, and CLI help inspection in the local workspace; no live GTK/X11 daemon run
- Entry point used: `README.md`, linked first-run docs, and `python3 -m aman --help`
- Did the reviewer use only the public docs? yes, plus CLI help

## First-run questions or confusions

- Question: Which hotkey am I supposed to press on first run?
  - Where it appeared: `README.md` quickstart before the first dictation step
  - How the docs or product resolved it: the README now names the default `Cmd+m` hotkey and clarifies that `Cmd` and `Super` are equivalent on Linux

- Question: Am I supposed to live in the service or run Aman manually every time?
  - Where it appeared: the transition from the quickstart to the ongoing-use sections
  - How the docs or product resolved it: the support matrix and `Daily Use and Support` section define `systemd --user` service mode as the default and `aman run` as setup/support only

## Remaining gaps

- Gap: The repo still does not point users at a real release download location
  - Severity: low for milestone 4, higher for milestone 5
  - Suggested follow-up: close milestone 5 with published release artifacts, project metadata, and the public download surface