# Agent Instructions for Chezmoi Dotfiles

## Build & Test Commands
- **Apply**: `chezmoi apply` (deploys changes to home directory).
- **Diff**: `chezmoi diff` (previews changes; ALWAYS run this before applying).
- **Add**: `chezmoi add ~/.config/<path>` (imports existing files).
- **Test**: No automated tests. Verify changes by applying and checking application behavior.

## Code Style & Conventions
- **Structure**: Follow `chezmoi` conventions (`dot_` for hidden, `executable_` for scripts, `.tmpl` for templates).
- **Lua (Neovim)**: Use tabs for indentation. Return tables for plugins. Follow LazyVim specs.
- **Fish**: Use 4 spaces indentation. Guard interactive logic with `if status is-interactive`.
- **Formatting**: Mimic existing file indentation (mostly 4 spaces, Lua uses tabs).
- **Templating**: In `.tmpl` files, wrap Go template logic in `{{ ... }}`.
- **Imports**: Keep config minimal. Verify plugin/tool availability before adding config.
- **Comments**: Explain *why* a specific hack/setting is needed.
- **Safety**: Use absolute paths. Read files before editing to preserve context.