AGENTS.md · diff

git:20260820.98e7163 to git:20261014.cb7a760

4 added, 0 removed. Audit A to A.

# Dotfiles Project
This repository manages shell configuration, aliases, completions, and utility scripts.
## Shell Configuration
`~/.zshrc` is a symlink to `zsh/zshrc.symlink` (created by `script/bootstrap`). All interactive shell configuration lives in this file.
Key files:
- `zsh/zshrc.symlink` — interactive shell: oh-my-zsh, tool managers, PATH, env vars, functions
- `zsh/zshenv.symlink` — all contexts: Homebrew, `~/.local/bin`, Cargo
- `zsh/zprofile.symlink` — login shells: .NET tools, OrbStack
- `zsh/aliases.zsh` — shell aliases
- `zsh/*-completion.zsh` — tab completion scripts
- `~/.secrets` — credentials (not tracked; sourced by `zshrc.symlink`)
+ ## Portable Skills
+
+ A portable skill can't use the `~/.dotfiles/` path exception in `ai/AGENTS.md`, because a cloud agent run unpacks it into a sandbox with no clone of this repo. The portable skills section of `ai/README.md` says which skills those are and what they may reference.
+