From 517140ad1fa9b38a8a27df8c15075636b90d9292 Mon Sep 17 00:00:00 2001 From: pmcc Date: Mon, 3 Aug 2026 20:10:01 -0400 Subject: [PATCH] AGENTS.md --- AGENTS.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..242e201 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,38 @@ +# 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 ` pulls live-edited files back into source