diff --git a/README.md b/README.md
index 1b2bc7e..0cfc40a 100644
--- a/README.md
+++ b/README.md
@@ -172,6 +172,22 @@ Note: This repo was built with AI assistance, and the contest pack itself is ful
 
 ---
 
+<details>
+<summary><strong>Git Theme (details)</strong></summary>
+
+The Git theme adds a repo-aware capsule on line 2 that only appears inside a Git repo. The branch name is wrapped as `⟦branch⟧`, and status emojis reflect state:
+
+- Clean: ✨
+- Dirty: 🔨
+- Staged: 📌
+- Untracked: 🧷
+- Stashed: 📦
+
+It uses the same two-block layout as Aurora, but focuses on signal and minimal noise for fast scanning.
+</details>
+
+---
+
 ## 😀 Emoji palette
 
 Fixed times (all seasons):