sync

AGENTS.md

@@ -0,0 +1,93 @@
+# AGENTS Guide: Dotfiles Repository
+
+Chezmoi-managed dotfiles with device-adaptive templates. Source files in `~/dotfiles/`, deployed to `~/` via `chezmoi apply`.
+
+## Device Profiles
+
+| Profile | Hostname | Primary Monitor | Has Touchpad | Has Battery |
+|---------|----------|-----------------|--------------|-------------|
+| desktop | box | DP-2 | No | No |
+| laptop | bluefin | eDP-1 | Yes | Yes |
+
+## Template Variables
+
+```go
+{{ .deviceProfile }}   // "desktop" or "laptop"
+{{ .hostname }}        // "box" or "bluefin"
+{{ .primaryMonitor }}  // "DP-2" or "eDP-1"
+{{ .hasTouchpad }}     // boolean
+{{ .hasBattery }}      // boolean
+{{ .idleTimeout }}     // 300 (desktop) or 180 (laptop)
+{{ .secretsPath }}     // "~/secrets"
+```
+
+## File Naming Conventions
+
+| Pattern | Effect |
+|---------|--------|
+| `private_dot_*` | Hidden file with 700 permissions |
+| `dot_*` | Hidden file with 755 permissions |
+| `executable_*` | Executable (755) |
+| `*.tmpl` | Processed as Go template |
+
+## Directory Structure
+
+```
+home/
+├── private_dot_config/     # ~/.config/
+│   ├── hypr/               # Hyprland configs
+│   ├── fish/               # Shell
+│   ├── waybar/             # Status bar
+│   └── ghostty/            # Terminal
+├── dot_local/bin/          # ~/.local/bin/ scripts
+└── .chezmoiscripts/        # One-time setup scripts
+```
+
+## Hyprland Config Files
+
+All in `home/private_dot_config/hypr/`:
+
+| File | Purpose |
+|------|---------|
+| `hyprland.conf.tmpl` | Main config, keybindings, window rules |
+| `monitors.conf.tmpl` | Monitor setup |
+| `autostart.conf.tmpl` | Startup applications |
+| `colors.conf` | Color palette |
+| `workspaces.conf` | Workspace definitions |
+| `hyprpaper.conf.tmpl` | Wallpaper |
+| `hypridle.conf.tmpl` | Idle/power management |
+| `hyprlock.conf` | Lock screen |
+
+## Template Conditionals
+
+```go
+{{- if eq .deviceProfile "desktop" }}
+# Desktop only
+{{- else if eq .deviceProfile "laptop" }}
+# Laptop only
+{{- end }}
+
+{{- if .hasBattery }}
+# Battery-dependent (laptop brightness keys, etc.)
+{{- end }}
+
+{{- if .hasTouchpad }}
+# Touchpad settings
+{{- end }}
+```
+
+## Key Commands
+
+```bash
+chezmoi apply          # Deploy changes
+chezmoi diff           # Preview changes
+chezmoi edit <file>    # Edit managed file
+chezmoi add <file>     # Add new file to management
+```
+
+## Standards
+
+- Scripts: `#!/usr/bin/env bash` with `set -euo pipefail`
+- Secrets: Store in `~/secrets/`, reference via `{{ .secretsPath }}`
+- Window rules: Use `windowrulev2` (not deprecated `windowrule`)
+- Whitespace: Use `{{-` to trim in templates