Features/Siri & Shortcuts

Feature

Siri & Shortcuts

Diorama exposes its core actions to Siri and the Shortcuts app through App Intents. You can ask for today's summary, log soreness or mood, and add a workout note by voice or as part of an automation — without opening the app.

Dana logs her soreness most reliably in the ninety seconds after a long ride, before she has peeled off her shoes. Opening an app in that window rarely happened. Saying "Log my soreness in Diorama" while still catching her breath did — and a month later she had the first continuous soreness record she had ever kept.

Why it matters

The best time to log how your body feels is the moment you notice it, not later when you remember to open an app. Voice and Shortcuts move logging to the moment, which is when the data is most honest and the friction is lowest.

How Diorama uses this

Ask Siri "How am I doing in Diorama" to hear today's summary out loud. Say "Log my soreness in Diorama" or "Log my mood in Diorama" to capture how you feel hands-free. Add a workout note by voice right after a session, or chain any of these into a Shortcuts automation.

What you can do

Diorama ships a small set of focused App Intents, each designed to be invoked without the app on screen:

  • "How am I doing in Diorama" / "My Diorama check-in today" — speaks today's summary.
  • "Log my soreness in Diorama" — records a soreness level from 1 to 10.
  • "Log my mood in Diorama" — captures how you are feeling.
  • "Add a note to my Diorama workout" — attaches a quick note to a session.

Because these are App Intents, they are also building blocks in the Shortcuts app. You can place a soreness log on your Lock Screen, trigger a check-in as part of a morning routine, or wire a post-run note into an automation.

Notes and limitations

Siri learns your shortcuts over time; running one once helps recognition. The deeper health-context export intent stays available for power users building their own automations but is kept off the promoted Siri phrases to keep the spoken surface simple.

The science

Self-report accuracy decays with delay; capturing a signal near the moment it occurs reduces recall bias. Lowering the effort of logging — fewer taps, no app launch, voice instead of typing — raises adherence, and adherence, not sophistication, is what makes longitudinal self-tracking useful. Voice and automation attack the friction directly.

Limitations

Siri phrasing recognition depends on iOS and improves when you run a shortcut once so the system learns it. The health-context export intent remains available for existing automations but is intentionally not promoted as a Siri phrase. Voice logging captures structured values (soreness level, mood, a short note) rather than free-form clinical detail.

A habit survives on how easy it is to start. When logging is a sentence you can say with your hands full, the record fills itself in. The point is not novelty for its own sake — it is that the easiest version of a good habit is the one that lasts.

Diorama

See your whole picture.

Diorama brings training, recovery, and health together so you keep competing — not just keep going.