From 2173d211a5b27d7475a44afd51ae0436dbbbd50b Mon Sep 17 00:00:00 2001
From: lexis <lexis@hyperhive>
Date: Tue, 26 May 2026 19:45:20 +0200
Subject: [PATCH] docs: add hive-forge diff verb to gotchas cheat sheet
 (follow-up to #481)

---
 docs/gotchas.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/gotchas.md b/docs/gotchas.md
index f41c9c90..32537c3d 100644
--- a/docs/gotchas.md
+++ b/docs/gotchas.md
@@ -133,6 +133,8 @@ hive-forge assign 42 damocles
 hive-forge close 42
 hive-forge labels 42 add feature
 hive-forge pr 42                            # PR metadata as JSON
+hive-forge diff 42                          # unified diff (lockfile hunks collapsed by default)
+hive-forge diff 42 --full                   # include unfiltered lockfile hunks
 hive-forge branches deployed/               # filter branches by pattern
 hive-forge -r other-org/other-repo pr 7     # target a different repo
 ```