docs: add initial design bundle

2026-09-04 11:02:53 -04:00
commit a16559c9c5
8 changed files with 185 additions and 0 deletions
@@ -0,0 +1,30 @@
+---
+type: User Story
+title: "US-003: Sort containers and player inventory"
+description: Let players use a Sorting Stick to consolidate and organize supported storage or their main inventory.
+status: backlog
+---
+
+# US-003: Sort containers and player inventory
+
+As a **player holding a Sorting Stick**, I want to sort storage containers or my main inventory so that related items are consolidated and organized automatically.
+
+## Acceptance criteria
+
+- [ ] Using the Sorting Stick on a chest sorts the complete chest inventory.
+- [ ] Using it on either half of a double chest sorts the combined inventory.
+- [ ] Using it on a barrel sorts that barrel.
+- [ ] Using it without targeting a supported container sorts the player's main storage slots.
+- [ ] Player hotbar, armor, and off-hand slots are not changed during player-inventory sorting.
+- [ ] Compatible partial stacks are consolidated without exceeding item stack limits.
+- [ ] Remaining stacks are placed in a deterministic, documented order.
+- [ ] Sorting preserves item quantities and all item metadata exactly.
+- [ ] Sorting respects cancelled interactions and normal container-access protections.
+- [ ] Unsupported or inaccessible targets fail safely without changing an inventory.
+- [ ] Sorting provides concise player feedback without opening the target container.
+- [ ] Automated tests cover single chests, double chests, barrels, player inventory boundaries, stack consolidation, metadata preservation, and rejected interactions.
+
+## Related
+
+- [US-002: Craft a Sorting Stick](us-002-craft-sorting-stick.md)
+- [User-story catalog](index.md)