docs: streamline guides and clarify agent instructions

[ReenigneArcher]

Description

Simplify docs and improve agent instructions. Also adds a small fix to ensure license validation is the same on macOS as on Windows.

Screenshot

Issues Fixed or Closed

Roadmap Issues

Type of Change

• feat: New feature (non-breaking change which adds functionality)
• fix: Bug fix (non-breaking change which fixes an issue)
• docs: Documentation only changes
• style: Changes that do not affect the meaning of the code (white-space, formatting, missing semicolons, etc.)
• refactor: Code change that neither fixes a bug nor adds a feature
• perf: Code change that improves performance
• test: Adding missing tests or correcting existing tests
• build: Changes that affect the build system or external dependencies
• ci: Changes to CI configuration files and scripts
• chore: Other changes that don't modify src or test files
• revert: Reverts a previous commit
• BREAKING CHANGE: Introduces a breaking change (can be combined with any type above)

Checklist

• Code follows the style guidelines of this project
• Code has been self-reviewed
• Code has been commented, particularly in hard-to-understand areas
• Code docstring/documentation-blocks for new or existing methods/components have been added or updated
• Unit tests have been added or updated for any new or modified functionality

AI Usage

See our AI usage policy.

• None: No AI tools were used in creating this PR
• Light: AI provided minor assistance (formatting, simple suggestions)
• Moderate: AI helped with code generation or debugging specific parts
• Heavy: AI generated most or all of the code changes

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-30T00:14:38.440922Z	1b82782	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1b82782dfc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[codecov]

Codecov Report

❌ Patch coverage is 70.58824% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 69.24%. Comparing base (2674189) to head (4f35977).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...atform/macos/broker/libvirtualhid_macos_broker.cpp	0.00%	5 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #172      +/-   ##
==========================================
- Coverage   70.59%   69.24%   -1.36%     
==========================================
  Files          47       47              
  Lines       10791    10803      +12     
  Branches     3792     3796       +4     
==========================================
- Hits         7618     7480     -138     
- Misses       2504     2952     +448     
+ Partials      669      371     -298     

Flag	Coverage Δ
FreeBSD	52.64% <77.77%> (+<0.01%)	⬆️
Linux-Clang	55.49% <88.88%> (+0.03%)	⬆️
Linux-GCC	66.22% <100.00%> (+0.05%)	⬆️
PowerShell	75.60% <ø> (ø)
Windows-MSVC	88.84% <100.00%> (+0.16%)	⬆️
Windows-MinGW-UCRT64	12.03% <0.00%> (-51.79%)	⬇️
macOS	44.38% <50.00%> (+0.05%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
src/platform/shared/lvh_broker_license_policy.hpp	100.00% <100.00%> (ø)
...atform/macos/broker/libvirtualhid_macos_broker.cpp	0.00% <0.00%> (ø)

... and 19 files with indirect coverage changes

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 2674189...4f35977. Read the comment docs.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud