aboutsummaryrefslogtreecommitdiff
path: root/sway/AGENTS.md
diff options
context:
space:
mode:
authorNick Moore <nicholasvmoore@gmail.com>2026-11-07 09:20:22 -0600
committerNick Moore <nicholasvmoore@gmail.com>2026-11-07 09:20:22 -0600
commit6c4039aebbe7ec25f47cb4623e44b96373e9e6e5 (patch)
tree6b29ac15408e586c41d6bc91561294709c87a962 /sway/AGENTS.md
parent34abcb44caf7266ce40063daca05a2a06f1b26c7 (diff)
Track sway (shared + rigel machine overlay), replace fibonacci with dwm-dwindle listener
- sway package: shared config (styling, all muscle-memory binds, no exec lines) including ~/.config/sway/machines/*.conf overlays included LAST; floating_windows + machines/README contract; sway/AGENTS.md doctrine - rigel package: machine overlay (outputs, touchpad, session stack, power bindings) + session scripts now stow-managed; fibonacci.py replaced by a POSIX sh+jq dwindle listener (dwm dwindle geometry, --monitor subscription, mark+move re-home, flock singleton); machines/rigel.conf exec line updated to the new path - validated in a headless nested sway against a literal port of fibonacci.c: five- and seven-window trees plus refocus-before-spawn all match dwm's rects (modulo the bar offset)
Diffstat (limited to 'sway/AGENTS.md')
-rw-r--r--sway/AGENTS.md33
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.