From 41a00b188afbdbee1ab390f8980996420b961eb5 Mon Sep 17 00:00:00 2001
From: vikingowl <christian@nachtigall.dev>
Date: Thu, 26 Mar 2026 18:57:25 +0100
Subject: [PATCH] docs: add per-crate tagging convention to CLAUDE.md

---
 CLAUDE.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index b98670c..c5c241b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -26,6 +26,19 @@ cargo build -p owlry-plugin-calculator --release
 # Bump versions
 just bump-crate owlry-plugin-weather 0.5.0  # Bump specific plugin
 just bump-all 0.5.0                          # Bump all plugins
+
+# Tagging convention: every changed crate gets its own tag
+# Format: {crate-name}-v{version}
+# Examples:
+#   owlry-plugin-bookmarks-v1.0.1
+#   owlry-plugin-calculator-v1.0.1
+#
+# IMPORTANT: After bumping, tag EVERY changed plugin crate individually.
+# Unchanged plugins don't need new tags.
+#
+# Plugin API dependency uses a git tag from the core repo:
+#   owlry-plugin-api = { git = "...", tag = "plugin-api-v1.0.1" }
+# Update this tag reference when the core repo bumps plugin-api.
 ```
 
 ## Workspace Structure