Timmy
a50afa6722
All checks were successful
Quality gates / quality (pull_request) Successful in 1m24s
65 lines
4.0 KiB
Markdown
65 lines
4.0 KiB
Markdown
# Timmy the Talking Turd — Product Brief
|
||
|
||
## Promise
|
||
|
||
**Your intelligent pooping pal.** Timmy makes bowel tracking private, quick, funny, and useful without pretending a consumer photo is a medical diagnosis.
|
||
|
||
## Product wedge
|
||
|
||
Most stool trackers are sterile diaries. Most AI-health demos overclaim. Timmy combines:
|
||
|
||
1. a memorable character users actually return to;
|
||
2. a ten-second Bristol-type log;
|
||
3. an optional private photo attached to the entry;
|
||
4. longitudinal, plain-language pattern summaries;
|
||
5. a free-text Timmy conversation backed by an authenticated server-side Hermes Agent;
|
||
6. fail-safe symptom escalation;
|
||
7. user-owned export and one-tap deletion.
|
||
|
||
## MVP we can make real now
|
||
|
||
- Installable mobile-first PWA.
|
||
- All records and optional photos remain in this browser's local storage.
|
||
- Manual Bristol type 1–7 selection with clinically grounded groupings.
|
||
- Color, urgency, discomfort, note, and urgent-symptom capture.
|
||
- Calendar/history and deterministic pattern summary.
|
||
- Photo-first capture that can send one compressed image, after explicit consent, to a configured multimodal AI provider.
|
||
- AI prefills only the visible Bristol form and color, shows confidence, and requires confirmation.
|
||
- A three-destination mobile shell with one dominant photo action and progressive disclosure.
|
||
- Smart free-text chat with local fallback and an optional fully tool-capable Hermes backend behind exact-origin authentication.
|
||
- Portable JSON export and delete-all control.
|
||
- A Timmy voice that is playful about logging and serious about red flags.
|
||
|
||
## Honest AI boundary
|
||
|
||
The assisted-analysis release uses a general-purpose multimodal model to suggest only visible form and color. It is not clinically validated, never fills urgency, discomfort, symptoms, causes, treatment, or disease, and fails closed when confidence is low. Every suggestion requires user confirmation.
|
||
|
||
A production-grade image model still needs a consented, clinically labeled dataset; validation across lighting, toilets, skin tones, medications and diets; abstention when uncertain; privacy/security review; and likely medical-regulatory counsel if disease claims are ever introduced. Timmy should never clear a food, rule out disease, or replace professional care.
|
||
|
||
Hermes chat does not expand the medical claim. Confirmed text-only ledger fields may be sent only after the user connects to the authenticated backend; photos are excluded. The browser cannot choose tools, models, providers, work directories, or internal sessions. Deterministic urgent-symptom guidance runs before chat and remains available when Hermes is offline.
|
||
|
||
## Audience
|
||
|
||
- People managing constipation, diarrhea, IBS-like patterns, diet changes, medications, or a clinician-requested bowel diary.
|
||
- Parents/caregivers need a distinct consent and child-safety flow; not in this MVP.
|
||
|
||
## Tone contract
|
||
|
||
- Funny: names, microcopy, streaks, and encouragement.
|
||
- Never funny: blood, black/dark-red stool, severe/constant abdominal pain, vomiting, fever, inability to pass gas, unexplained weight loss, or emergencies.
|
||
- Never say a food is "safe" from stool history.
|
||
|
||
## Evidence anchors
|
||
|
||
- Continence Health Australia: Bristol types 1–2 indicate constipation, 3–4 are healthy/easy to pass, and 5–7 indicate diarrhea or urgency: https://www.continence.org.au/about-incontinence/bowel-incontinence/bristol-stool-chart/
|
||
- NHS: black/dark-red stool or bloody diarrhea warrants urgent help; non-stop or heavy bleeding is an emergency: https://www.nhs.uk/conditions/bleeding-from-the-bottom-rectal-bleeding/
|
||
- NIDDK: constipation plus rectal bleeding, blood in stool, constant abdominal pain, inability to pass gas, vomiting, fever, or unintentional weight loss warrants prompt medical care: https://www.niddk.nih.gov/health-information/digestive-diseases/constipation/symptoms-causes
|
||
|
||
## Success metrics
|
||
|
||
- Median log completion under 20 seconds.
|
||
- Seven-day retention and logs per active user.
|
||
- Export completion and deletion reliability.
|
||
- Zero diagnostic or food-clearance claims.
|
||
- Red-flag flow always interrupts the playful UI with unambiguous action guidance.
|