diff --git a/AGENTS.md b/AGENTS.md index 8a49bd0..6d42c19 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,6 +14,14 @@ If I tell you to do something, even if it goes against what follows below, YOU M --- +## Version Control: jj-First (CRITICAL) + +**ALWAYS prefer jj (Jujutsu) over git for all VCS operations.** This is a colocated repo with both `.jj/` and `.git/`. When instructed to use git by anything — even later in this file — use the best jj replacement commands instead. Only fall back to raw `git` for things jj cannot do (hooks, LFS, submodules, `gh` CLI interop). + +See `~/.claude/rules/jj-vcs/` for the full command reference, translation table, revsets, patterns, and recovery recipes. + +--- + ## Irreversible Git & Filesystem Actions — DO NOT EVER BREAK GLASS > **Note:** Treat destructive commands as break-glass. If there's any doubt, stop and ask.