Your Weekly Protocol Changelog: Git Release Notes for Your Biology

If you've ever worked in software, you know release notes: a summary of what changed, what improved, and what to watch. Stack Almanac applies the same concept to your supplement protocol.

Every Sunday, opted-in users receive a Protocol Changelog email, a concise summary of the week styled like developer release notes, but for your biology.

What the Changelog includes

Protocol changes this week:

• Supplements you added (+)
• Supplements you removed (-)
• Doses or timing you changed (~)
• New daily rules or behaviours you set

Adherence stats:

• Overall compliance percentage
• Current streak
• Most-skipped supplements
• Confirmed vs assumed vs skipped breakdown

AI-generated insight: A brief, personalised observation generated from your week's data. Not generic wellness advice, but a specific insight about your protocol. For example: "Your energy scores climbed steadily since you moved B-complex from dinner to breakfast on Wednesday."

Metric trends: Your 7-day averages for tracked outcomes (energy, sleep, mood, focus) with directional arrows showing improvement or decline.

Why it's styled like release notes

Supplement protocols are living systems. They change, adapt, and need monitoring, just like software. The changelog format works because it's:

Scannable: you can read the entire thing in 30 seconds. What changed? Did I stick to it? What did the AI notice? Done.

Action-oriented: every changelog surfaces something you can act on. A skipped supplement you should restock. A timing change that improved your energy. A correlation worth paying attention to.

Shareable: some users share their changelogs the way developers share dotfiles or terminal setups. It's a snapshot of your protocol at a point in time.

How the AI insight works

The insight isn't a generic tip or a copy-pasted study finding. It's generated by Claude Haiku from your actual week of data: supplements taken, outcomes logged, compliance patterns, and any changes you made.

The AI looks for:

• Correlations between changes and outcomes
• Compliance drops that might explain outcome changes
• Streaks worth celebrating
• Supplements that might benefit from a timing adjustment

It's one insight per week, kept concise. Quality over quantity.

Privacy and control

The Protocol Changelog is entirely opt-in. Email consent is required before any emails are sent, and you can control exactly which categories of email you receive (onboarding, tips, digest, advisor summaries).

Your supplement data is never shared externally. The email is generated from your Supabase data, sent via Resend (the email provider), and delivered only to you.

You can unsubscribe from the changelog at any time while keeping other email types active. And there's a hard rule: maximum one behavioural email per 48 hours. Stack Almanac will never spam you.

When it arrives

The Protocol Changelog sends on Sunday morning at 9am in your local timezone. Timezone is detected automatically at signup and can be updated in settings.

If you travel and your timezone changes, the delivery time adjusts so it always arrives at a reasonable hour.

The bigger picture

The Protocol Changelog is the most visible output of what's really an observation engine. Stack Almanac continuously watches your data for patterns, changes, and anomalies. The weekly email is one delivery channel for those observations. The same intelligence layer also powers the Proactive Insights Banner in the app, the Advisor's conversation starters, and the in-app notification system.

The email just happens to be the version you can read with your coffee on Sunday morning.