docs(design): define harvest progression stories

This commit is contained in:
dmg
2026-08-14 18:13:47 -04:00
commit b8583901f5
11 changed files with 299 additions and 0 deletions
@@ -0,0 +1,27 @@
---
type: User Story
title: "US-001: Track crop harvesting progression"
description: Track qualifying harvest activity independently for each player and supported crop.
status: backlog
---
# US-001: Track crop harvesting progression
As a **player**, I want my mature crop harvests tracked separately by crop so that my experience with each crop unlocks its own harvesting benefits.
## Acceptance criteria
- [ ] Initial progression paths exist independently for wheat, carrots, potatoes, and beetroot.
- [ ] A crop contributes progress only when it is fully grown at the time a player harvests it.
- [ ] Only crops harvested by a player in Survival mode contribute progress by default.
- [ ] A manually broken mature crop contributes one unit to its matching crop path.
- [ ] Each mature crop collected by an auto-harvest operation contributes one unit to the player who started that operation.
- [ ] Sneaking prevents a manual break from starting auto-harvest but does not prevent the mature triggering crop from contributing progress.
- [ ] Immature crops, unsupported crops, and non-harvest block changes do not contribute progress.
- [ ] Progress is associated with the player's UUID and survives reconnects and server restarts.
## Related
- [US-002: Unlock crop auto-harvest levels](us-002-unlock-crop-auto-harvest-levels.md)
- [US-003: Harvest connected mature crops](us-003-harvest-connected-mature-crops.md)
- [US-007: Configure and persist harvesting behavior](us-007-configure-and-persist-harvesting-behavior.md)