docs(design): define Tree Feller user stories

2026-08-11 17:07:13 -04:00
commit de27d6519e
12 changed files with 333 additions and 0 deletions
@@ -0,0 +1,30 @@
+---
+type: User Story
+title: "US-004: Control personal tree felling"
+description: Let players persistently enable or disable their own automatic tree felling.
+status: backlog
+---
+
+# US-004: Control personal tree felling
+
+As a **player**, I want to turn automatic felling on or off independently of my unlocks so that I remain in control of how I mine.
+
+## Acceptance criteria
+
+- [ ] `/treefeller enabled <on|off>` enables or disables automatic felling for the issuing player.
+- [ ] `/treefeller enabled` without a value reports the player's current preference and whether an administrative lock currently overrides it.
+- [ ] The preference defaults to enabled for a player with no saved value.
+- [ ] Changing the preference does not alter species progress or earned unlocks.
+- [ ] Repeating the currently saved value is idempotent and reports that no change was needed.
+- [ ] The player receives clear confirmation after a successful change.
+- [ ] The saved preference survives logout and server restart.
+- [ ] `/treefeller` provides concise usage for `enabled`, `unlocked`, and `undo` without advertising inaccessible administrative commands.
+- [ ] Position-aware autocomplete suggests player subcommands and valid `on` or `off` values.
+- [ ] Player commands use player permissions that are distinct from `treefeller.admin`; possession of player permissions does not grant `/treefelleradmin` access.
+
+## Related
+
+- [US-002: View tree progress](us-002-view-tree-progress.md)
+- [US-003: Fell unlocked trees](us-003-fell-unlocked-trees.md)
+- [US-007: Administer Tree Feller](us-007-administer-tree-feller.md)
+- [US-008: Configure and persist Tree Feller](us-008-configure-and-persist-tree-feller.md)