From 8d1855229803c577f5f8a174136f41cc0154ab4d Mon Sep 17 00:00:00 2001 From: Taylor Eernisse Date: Wed, 11 Feb 2026 10:23:01 -0500 Subject: [PATCH] docs: add jj-first VCS policy to AGENTS.md Establishes Jujutsu (jj) as the preferred VCS tool for this colocated repo, matching the global Claude Code rules. Agents should use jj equivalents for all git operations and only fall back to raw git for hooks, LFS, submodules, or gh CLI interop. Co-Authored-By: Claude Opus 4.6 --- AGENTS.md | 8 ++++++++ 1 file changed, 8 insertions(+) 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.