wayland-shot/AGENTS.md

Project Rules - Wayland Shot

Scope

• Build a lightweight Wayland-first screenshot tool for KDE Plasma on Debian-based Linux.
• Primary target machine is the user's Lenovo laptop on KDE Wayland.
• v1 scope is region and fullscreen capture, annotation editing, copy, save, and save as.

Working Rules

• Prefer KDE-native integration paths first, then fall back to generic portal paths.
• Keep the runtime lean: no heavy background daemon for v1.
• Treat global shortcut support as KDE-first. Document any compositor conflicts before changing the default combo.
• Prioritize stable cancel paths, clipboard robustness, and editor responsiveness over feature breadth.
• Keep packaging simple and Debian-friendly.

Current Product Decisions

• Preferred stack: C++ + Qt6.
• Hotkey target: Alt+Shift+F12. KDE may not distinguish left and right modifiers for global shortcuts, so document that limitation explicitly in the app and docs until proven otherwise.
• Out of scope for initial v1: window capture, blur, upload/share, screenshot history, advanced object transforms, cross-desktop guarantees.