dotfiles/AGENTS.md

AGENTS.md

Guidance for AI agents working in this repo. See README.md for full documentation.

What this is

chezmoi source state. Files here deploy to $HOME (~/.local/share/chezmoi → /home/pmcc). Edit files here, never the live copies under ~/.

Naming conventions

Pattern	Effect
dot_foo	deploys as .foo
executable_*	deployed with +x
*.tmpl	rendered as Go template, deployed minus suffix
.chezmoitemplates/	shared fragments, never deployed
.chezmoiignore.tmpl	target-path ignore patterns, never deployed

Templates that render to empty output are not deployed — this is intentional, don't "fix" it.

Per-host config

Hosts: flow (desktop), gata (desktop/work), framework13pro (laptop). .chezmoi.toml.tmpl maps hostname → hosttype data var. Branch templates on .chezmoi.hostname or .hosttype. .chezmoiignore.tmpl scopes app configs per host (pulsemeeter → flow only, teams-for-linux → desktops).

Rules

• No secrets in this repo
• Verify before applying:
  • chezmoi diff — preview target changes
  • chezmoi execute-template --init < file.tmpl — render one template
  • chezmoi apply --destination /tmp/test — render everything to a scratch dir
  • chezmoi status — pending changes
• Workflow: edit source → chezmoi diff → chezmoi apply -v → commit/push from this dir
• chezmoi re-add <path> pulls live-edited files back into source