From 25f31536bb3ff513ba6953e3a7a932d772d981dc Mon Sep 17 00:00:00 2001 From: Josh Nichols Date: Fri, 8 May 2026 09:41:32 -0400 Subject: [PATCH] docs(adr/0031): cross-ref git:push skill for push-failure diagnosis When a push under the agent identity fails with mixed lefthook + SSH output, agents have misread it as an SSH transport issue and then debugged with GIT_SSH_COMMAND="ssh -v", which silently drops the -i and IdentitiesOnly flags configured here. Cross-ref the new git:push skill in pickled-claude-plugins for the diagnosis recipe. Co-Authored-By: Claude Opus 4.7 (1M context) --- doc/adr/0031-role-scoped-agent-git-identity.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/adr/0031-role-scoped-agent-git-identity.md b/doc/adr/0031-role-scoped-agent-git-identity.md index 75df9a6..e6ed0d7 100644 --- a/doc/adr/0031-role-scoped-agent-git-identity.md +++ b/doc/adr/0031-role-scoped-agent-git-identity.md @@ -232,3 +232,15 @@ agent under a given role. Keeping identity on the role axis means: `home/.gitconfig.d/claude-agent-` include file) rather than one env block. The trade is a more readable gitconfig vs. the opaque `GIT_CONFIG_COUNT/KEY/VALUE` scheme it replaced + +## See also + +When debugging a `git push` failure in an agent session, the `git:push` +skill in +[pickled-claude-plugins](https://github.com/technicalpickles/pickled-claude-plugins) +covers reading mixed transport+hook output and how to add `-v` without +dropping the `core.sshCommand` configured here. Specifically: use +`GIT_SSH_COMMAND="$(git config core.sshCommand) -v"` rather than +`GIT_SSH_COMMAND="ssh -v"`, which would replace the agent-key flags +(`-i`, `IdentitiesOnly=yes`, `IdentityAgent`) and make it look like the +wrong keys are being offered.