docs(design): define Leaf user stories

design/log.md

@@ -0,0 +1,16 @@
+# Leaf Design Log
+
+## 2026-08-10
+
+### Initial protection design
+
+- Leaf is available to any player who opts in; the seven-day period applies only to onboarding reminders.
+- Protection grants Resistance I by default and remains active until the player opts out, attacks another player, an administrator disables it for the player, or Leaf is globally disabled.
+- Receiving an attack does not remove protection, but retaliating does, including attributable Thorns damage.
+- PvP attribution covers melee, projectiles, potions, owned animals, Thorns, and indirect damage when Spigot exposes a reliable responsible player.
+- Opted-in players receive a leaf prefix in tab, overhead names, and chat where supported.
+- New players receive an onboarding reminder on every login for seven calendar days after first joining.
+- Global disablement suppresses effects, prefixes, and reminders without erasing player choices.
+- Administration uses the permission-aware `/leaf` command tree with autocomplete.
+- Builds and releases follow the neighboring Spigot Base Gradle and Gitea pipeline.
+- The design bundle is committed together; later implementation work is committed separately for each user story.