dotfiles/docs/README.md
Felipe Martin 2494760df1
Manage ~/.agents so skills follow the machines, and keep knowledge in git.
npx-managed skills stay copies so an installer update cannot land in the repo by accident; knowledge is a symlink outside home/ so maintain writes are tracked instead of dying on the next apply. Verified the live ~/.agents/knowledge link and that the lockfile is named dot_skill-lock.json so chezmoi does not ignore it.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-26 18:27:53 +02:00

1 KiB

Docs

config/metapac.md How packages are declared, why every host needs a baseline group, and what metapac clean does to a machine without one. Read before onboarding a new host.
config/git.md Commit signing through 1Password over SSH rather than GPG, credential handling, aliases, and how to register a signing key with a forge.
config/claude.md Why settings.json is merged instead of owned, and what the status line shows — including the cache hit rate and how it degrades on team accounts.
config/agents.md Why ~/.agents/knowledge is a symlink into the repo, why skills stay copies owned by npx skills, and why those writes never reach the source until chezmoi add.
dotfiles-command.md The dotfiles maintenance command and the three things it deliberately refuses to do.

Conventions for changing any of this, including what belongs in these files, are in AGENTS.md.