chore: add PR documentation update workflow

[Copilot]

Summary

Adds a PR-triggered gh-aw workflow that identifies documentation-impacting changes and updates relevant project documentation in the same PR.

Changes

• Documentation coverage

  • Reviews MkDocs content, README files, examples, and AI context (AGENTS.md, SKILL.md).
  • Skips internal-only, test-only, CI-only, and formatting-only changes.

• Safe PR updates

  • Limits writes to documentation-related paths.
  • Pushes updates to the originating PR branch or reports a no-op/fork limitation.

• Validation

  • Installs the MkDocs dependency group before the agent runs.
  • Requires MkDocs builds for changed published documentation.

[github-actions]

Benchmark comparison for e6ca0442 (base) vs 73fdea59 (PR)

------------------------------------------------------------------------------------------------------------------- benchmark: 2 tests ------------------------------------------------------------------------------------------------------------------
Name (time in ms)                                                                         Min                 Max                Mean             StdDev              Median                IQR            Outliers     OPS            Rounds  Iterations
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
test_benchmark_process_run (pr/.benchmarks/Linux-CPython-3.14-64bit/0001_pr)         526.1195 (1.0)      547.9328 (1.0)      536.8173 (1.0)       8.0963 (1.0)      537.2927 (1.0)      10.6037 (1.0)           2;0  1.8628 (1.0)           5           1
test_benchmark_process_run (main/.benchmarks/Linux-CPython-3.14-64bit/0001_base)     536.9570 (1.02)     565.7712 (1.03)     547.0606 (1.02)     11.6608 (1.44)     542.1729 (1.01)     15.4821 (1.46)          1;0  1.8280 (0.98)          5           1
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Legend:
  Outliers: 1 Standard Deviation from Mean; 1.5 IQR (InterQuartile Range) from 1st Quartile and 3rd Quartile.
  OPS: Operations Per Second, computed as 1 / Mean

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!