# Docs

| | |
|---|---|
| [config/metapac.md](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](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](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](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](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](../AGENTS.md).