16 lines
1.4 KiB
Markdown
16 lines
1.4 KiB
Markdown
|
# Project notes for agents
|
||
|
|
|
||
|
|
Deliberate decisions in this repo - do NOT silently revert them:
|
||
|
|
|
||
|
|
- `homebrew.onActivation.cleanup = "zap"` in `configuration.nix` is intentional. It forces the good habit of declaring every Homebrew package in the Nix config instead of installing things ad-hoc, which keeps the machine reproducible. Do not soften it to `uninstall` or `none`. Users are warned about its effect; this note is for anyone tempted to change the setting itself.
|
||
|
|
- Agent configs under `home/` are the source of truth. `home.nix` installs them with `mkOutOfStoreSymlink`, so edits to files in `home/` apply live after the first rebuild that creates the symlink. Prefer editing those paths, not the live `~/.claude` / `~/.grok` copies.
|
||
|
|
- Grok Build is first-class here: `home/.grok/config.toml` and `home/AGENTS.md` (linked as `~/.grok/AGENTS.md`). Claude, Codex, and opencode still share the same `home/AGENTS.md` for multi-agent work.
|
||
|
|
- Shell aliases: `cc` (Claude skip-permissions), `co` (Codex full-auto), `gb` (Grok --yolo). They are intentional high-agency shortcuts.
|
||
|
|
|
||
|
|
## Maintaining this file
|
||
|
|
|
||
|
|
Keep this file for knowledge useful to almost every future agent session in this project.
|
||
|
|
Do not repeat what the codebase already shows; point to the authoritative file or command instead.
|
||
|
|
Prefer rewriting or pruning existing entries over appending new ones.
|
||
|
|
When updating this file, preserve this bar for all agents and keep entries concise.
|