Use the repository docs and issue templates first:
- README for product behavior and command examples
- docs/architecture.md for the high-level runtime model
- docs/subsystems.md for code ownership by subsystem
- Bug: open a bug report issue
- Feature idea: open a feature request issue
- Security concern: use private vulnerability reporting, not a public issue
For anything device-facing or runtime-facing, include:
- host OS
- exact command or scenario
- target device details when relevant
- expected behavior
- actual behavior
- logs, artifacts, or screenshots
The faster route to a useful answer is a minimal reproduction plus the exact command line that failed.