diff --git a/AGENTS.md b/AGENTS.md index 01712c9..bf342b6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,6 +24,13 @@ This repository is a screen reader. Prioritize accessibility, correctness, and s - If repo and installed behavior differ, prefer rebuilding with `./build-local.sh` over patching the installed package directly. - Treat direct edits under `~/.local/.../cthulhu/` as an exception path that requires explicit user approval. +## Platform support stance +- **critical** Robust Xorg support is required and is a merge gate for Cthulhu. +- Wayland support is desirable, but it is secondary to keeping Xorg stable and usable. +- If a change that improves Wayland would break, weaken, or regress Xorg support, the answer is a hard no by default. +- If the user explicitly insists on such a change anyway, warn them plainly that the change is expected to be rejected without further consideration as long as Xorg is adversely affected. +- Prefer desktop-agnostic fixes first. If a tradeoff is unavoidable, choose the path that preserves Xorg correctness and defer the Wayland-specific improvement. + ## Coding guidelines - **When modifying existing code:** follow the surrounding code’s conventions. - **When writing new code from scratch:** prefer