baketnk--frame-yap/AGENTS.md

# Frame Dictation development

This is an independent project, not a plugin for another application.
Read README.md and docs/design.md before implementation. Dated evidence records
past observations; it never proves current device availability or grants a live run.

- Keep dependencies explicit and small. Do not add a dependency/submodule/symlink
  to an unrelated application's build tree, assets or Python environment.
- External source reuse needs a deliberate, license-reviewed standalone extraction,
  not hidden coupling.
- Preserve the one-command GitHub installation goal: no Steam store AppID, sudo
  or end-user compiler requirement. See docs/install-design.md. Do not publish a
  placeholder installer as functional or conflate an OpenVR app key with a store ID.
- Default builds and tests are offline and hardware-free. No implicit package/model
  downloads, microphone recording, input injection or OpenVR initialization.
- Hardware tests must be opt-in and distinguish API discovery from delivered input,
  transcription quality, performance and human headset acceptance.
- Preserve existing SSH and user sessions; never terminate SSH/session processes or
  use broad cleanup/restart commands. Stop only processes this project owns.
- Keep audio, transcripts, model weights, credentials and private logs out of Git.
  No automatic Enter/submit, speech commands or cloud/desktop ASR fallback.
- Build/check: `cmake -S . -B build && cmake --build build`, then
  `ctest --test-dir build --output-on-failure` and `git diff --check`.
- Keep docs honest about implemented versus proposed behavior. Review exact diffs
  and create small verified commits.