diff --git a/.mailmap b/.mailmap
new file mode 100644
index 0000000..2ad0f64
--- /dev/null
+++ b/.mailmap
@@ -0,0 +1,14 @@
+# Normalize troupe commit attribution for `git log` / `git shortlog`.
+# This does NOT rewrite history — it only affects how names/emails are displayed.
+# Canonical per wizard:
+Timmy <timmy@stackchain.ai> timmy <timmy@stackchain.ai>
+Timmy <timmy@stackchain.ai> <timmy@alexanderwhitestone.com>
+Timmy <timmy@stackchain.ai> <timmy@agents.invalid>
+Timmy <timmy@stackchain.ai> <timmy@stackchain.invalid>
+Timmy <timmy@stackchain.ai> <timmy@hermes>
+Timmy <timmy@stackchain.ai> <timmy@stacktimmy.invalid>
+Timmy <timmy@stackchain.ai> <timmy@localhost>
+Zephyrus Sparkborn <zephyrus-sparkborn@agents.invalid> <zephyrus-sparkborn@users.noreply.forge.alexanderwhitestone.com>
+Zephyrus Sparkborn <zephyrus-sparkborn@agents.invalid> <zephyrus-sparkborn@users.noreply.github.com>
+Zephyrus Sparkborn <zephyrus-sparkborn@agents.invalid> <zephyrus-sparkborn@noreply.local>
+Cassian Assayborn <cassian@agents.invalid> <cassian@forge.local>