diff --git a/docs/abra/trouble.md b/docs/abra/trouble.md
index 8872854f7..264f38a75 100644
--- a/docs/abra/trouble.md
+++ b/docs/abra/trouble.md
@@ -83,3 +83,21 @@ This appears to be an upstream issue for which we can't do much in `abra` to sol
 ## Caller path in debug stacktrace doesn't exist
 
 Debug stacktrace currently begins with `/drone/` due to CI. Remove the initial `/drone/` and the path is relative to the abra project root.
+
+## `failed to select default branch` error
+
+General speaking, this error should happen in the > v0.10.x `abra` version series. You can try upgrading if you're on an old version: `abra upgrade`.
+
+If you're really stuck, `rm -rf`'ing the relevant recipe repository and catalogue might do the trick.
+
+```
+$ abra app new foobar
+FATA[0000] unable to validate recipe: failed to select default branch in /root/.abra/catalogue
+$ rm -rf ~/.abra/recipes/foobar ~/.abra/catalogue
+```
+
+Otherwise, you can try manually cloning the recipe repository to the correct location.
+
+```
+$ git clone https://git.coopcloud.tech/coop-cloud/MyCoolRecipe.git ~/.abra/recipes
+```