# Aman Target Persona and Distribution Strategy ## Primary Persona: Desktop Professional This is the canonical Aman user. - Uses Linux desktop daily (X11 today), mostly Ubuntu/Debian. - Wants fast dictation and rewriting without learning Python tooling. - Prefers GUI setup and tray usage over CLI. - Expects normal install/uninstall/update behavior from system packages. Design implications: - End-user install path must not require `uv`. - Runtime defaults should work with minimal input. - Documentation should prioritize package install first. ## Secondary Persona: Power User - Comfortable with CLI, package internals, and model customization. - Uses advanced config, external APIs, or custom models. - Can run diagnostics and debug logs when needed. Design implications: - Keep Make and Python workflows available. - Keep explicit expert-mode knobs in settings and config. - Keep docs for development separate from standard install docs. ## Supported Distribution Path (Current) Tiered distribution model: 1. Canonical: Debian package (`.deb`) for Ubuntu/Debian users. 2. Secondary: Arch package inputs (`PKGBUILD` + source tarball). 3. Developer: wheel/sdist from `python -m build`. ## Out of Scope for Initial Packaging - Wayland production support. - Flatpak/snap-first distribution. - Cross-platform desktop installers outside Linux. ## Release and Support Policy - App versioning follows SemVer (`0.y.z` until API/UX stabilizes). - Config schema versioning is independent (`config_version` in config). - Packaging docs must always separate: - End-user install path (package-first) - Developer setup path (uv/pip/build workflows)