From ec11b4ebc1c5476c3be99388ad32fe632526e8c7 Mon Sep 17 00:00:00 2001
From: Matthijs Berends <31037261+msberends@users.noreply.github.com>
Date: Sun, 29 Mar 2026 16:53:37 +0200
Subject: [PATCH] docs: instruct Claude to install git and gh before computing
 version

---
 CLAUDE.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 4892f3c00..cce4f7a73 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -152,7 +152,16 @@ All PRs are **squash-merged**, so each PR lands as exactly **one commit** on the
 
 #### Computing the correct version number
 
-Run the following from the repo root to determine the version string to use:
+**First, ensure `git` and `gh` are installed** — both are required for the version computation and for pushing changes. Install them if missing before doing anything else:
+
+```bash
+which git || apt-get install -y git
+which gh   || apt-get install -y gh
+# Also ensure all tags are fetched so git describe works
+git fetch --tags
+```
+
+Then run the following from the repo root to determine the version string to use:
 
 ```bash
 currenttag=$(git describe --tags --abbrev=0 | sed 's/v//')