Arya Quest: doc pack
Quest is the optional game layer of Arya, a grocery app that learns how you
shop from your receipts and helps shoppers help each other (see the root README.md). Team Nightshift,
Indie track, submission Nov 4, 2026, 9:00 PM ET.
Quest turns your grocery list into a treasure hunt in your real store. Pick the store. Arya sorts your list by where you usually buy each thing. Walk the hunt through real photos of the aisles and grab each item (points only go up, no clock). With Find it for me, you point the camera at the shelf and the item lights up. Snap the receipt at checkout. It banks your points and teaches Arya your household, so next week's list writes itself.
An unmapped store still plays, as a labelled typical layout. A guided camera scan maps it for every shopper after you.
Loop
Plan → Find → Grab → Receipt.
- Plan. The list arrives in any form (photo, paste, typing, voice, Muse chat). Pick the store. The list is sorted for it from your receipts.
- Find. Shoppers' photos where a store section is mapped (people pixelated by SAM 3.1), and a labelled typical layout elsewhere. Find it for me: SAM 3.1 boxes candidates, and Muse Spark verifies them.
- Grab. +10 per grab, milestones, a full-haul bonus. Shortage reports and sightings feed a live store map.
- Receipt. Muse Spark reads it (Spark first; see the model map in
JUDGES.md). Code checks the arithmetic. The receipt then feeds patterns, spend and returns.
Documents
| File | What it holds |
|---|---|
| GAME-DESIGN.md | Rules, loop, rewards, Spotter, community |
| UX.md | Sessions, flow, store view, intake. Oct 27 rules, archived on 2026-11-04; the wireframes are the design of record |
| wireframes.html | Clickable design of record |
| game-flow-prototype.html | The game flow, tap through on one phone |
| ARCHITECTURE.md | Data planes and pipelines |
| META-PRODUCTS.md | Each Meta product and its job |
| JUDGE-PLAYBOOK.md | An 8-minute path through the live demo |
| PITCH-SCRIPT.md | The spoken script. The early game-first PITCH.md was archived on 2026-11-04. |
| BUSINESS.md | Who it is for and who else is out there |
| BUILD-PLAN.md, SUBMISSION.md | Road to Nov 4 and the package checklist. Archived on 2026-11-04. |
| DISCUSSION.md | My steering, in order |
Current state: STATUS.md at the repo root. Every document in the
repository, grouped by reader: docs/README.md.