diff options
Diffstat (limited to 'sway/AGENTS.md')
| -rw-r--r-- | sway/AGENTS.md | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/sway/AGENTS.md b/sway/AGENTS.md new file mode 100644 index 0000000..bb5532e --- /dev/null +++ b/sway/AGENTS.md @@ -0,0 +1,33 @@ +# sway — Component Context + +Parent rules: `../AGENTS.md` (repo root). This package holds the SHARED +sway config for every sway-using machine. + +## The split doctrine + +- Tracked `config` = shared, machine-agnostic layer: doom-one palette + variables, fonts, borders/gaps/titlebars, window rules, ALL muscle-memory + key bindings (vim motions, workspaces, screenshots, volume/media/ + brightness, resize mode), behavioral QoL. NO exec lines, no machine + paths, no output names. +- Machine overlays: `~/.config/sway/machines/<hostname>.conf`, included + LAST — they may override anything above and may ONLY contain hardware + shape (outputs, input blocks), that machine's session stack (autostart + of its own scripts), lock/idle, and power behavior. NEVER styling. In + this repo the pattern is delivered by per-machine packages (currently + `../rigel`); see `machines/README.md` for the contract. +- Sway precedence facts the split relies on: specific `output <name>` + rules beat `output *`; later bindsym definitions win; `include` is + re-evaluated on every `swaymsg reload`. + +## Include depth constraint + +Sway's include is one level deep: `machines/*.conf` files are included +directly by the main config and must NOT themselves contain `include`. + +## Session scripts + +Referenced autostart scripts are per-machine repo content (rigel package +ships its supervisor/fibonacci/ppd/veila helpers). The shared config +contains no exec lines, so a bare `stow sway` on a new machine yields a +working, safe desktop before that machine's overlay lands. |
