[joshschmelzle]

Why

This repository states the standard: how and why WLAN Pi work is done, and what the result should be. It is not an inventory of what repositories currently are. When a repository differs, that is drift to fix in that repository, or a deliberate change to the standard. It is not a documentation error.

What changed

• README.md, AGENTS.md, and agents/AGENTS.md open with that purpose.
• New work targets Python 3.13. Bullseye is 3.9, Bookworm is 3.11, Trixie is 3.13. debian/bookworm and debian/bullseye exist only for a hotfix to an old release, and that hotfix uses the suite's Python. New work never targets those branches.
• Plan and test on 3.13. requires-python stays >=3.13. The docs no longer say the policy is "not 3.13+".
• Org standards win on a cross-cutting rule. A repo AGENTS.md may add build, release, and test rules for that repo. A conflict on a cross-cutting rule is drift to raise.
• CI stays on Debian Trixie packaging, plus compiler builds and tests. No sid, Bookworm, Ubuntu, Arch, or Fedora jobs, and no Arch or RPM version tracking.
• A forked upstream project versions as <upstream>+wlanpi<N>, for example 2.3.0+wlanpi1. RELEASING.md Scope and the packaging doc say so.
• WLAN Pi Go is BE200-only, ships only that firmware (iwlwifi-gl-c0-fm-c0-* ucode plus pnvm), must not ship or run wpa_supplicant, and must let the user set the regulatory domain. wlanpi-desktop is an apt option, not preinstalled in the full image.
• An issue states problem, evidence, impact, done-when criteria, and constraints. An approach goes in Notes and is not binding.
• Release bullets match What Is Live. A changelog push to main uploads to wlanpi/dev. Promotion to wlanpi/main is by hand. An upload to wlanpi/main on release-PR merge, and an automatic tag, are planned and not live.

agents/AGENTS.md is 126 lines. REPOS.md is not in this pull request.

Squash

Commit aa505b3 carries a Co-authored-by trailer. Do not rewrite that commit. The squash merge message must drop that trailer.

Still open

• An agent-tool check that the file steers away from a cruft pattern.
• The per-repo stub rollout.

  

---

Note

Low Risk
Documentation-only changes to standards and agent guidance; no runtime, CI, or packaging behavior is modified in this PR.

^{Reviewed by Cursor Bugbot for commit a4e72f1. Bugbot is set up for automated code reviews on this repo. Configure here.}

[joshschmelzle]

Drafted these, but still want a review.

[cursor]

Approved. Cursor Bugbot completed successfully and reported no findings that need human review. No approval policy requires additional review on this documentation change.

  

_{Sent by Cursor Approval Agent: Pull Request Router and Approver}