# 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