# GentleGain Planner – Hermes Prompts & Cron Setup

Use these directly with your Hermes agent (remote on VPS).

## Core Style Guide (include in every prompt)
- Voice: warm, nourishing, gentle, affirming, grounded. “We” + “you”. Sentence case.
- Focus: calorie-dense but anti-inflammatory, make-ahead friendly, easy on shy appetites.
- Include easierToEat notes where relevant.
- Reference existing gainingwithgrace.com recipes when possible (seed the library with the 18+ recipes).
- Output clean structured JSON (or markdown that can be parsed).

## Example 1 – Weekly Plan Refresh (High Priority Cron)
```
Every Sunday at 3:00 AM, for every active Pro user:

1. Load user profile: goals, daily calorie target, dietary restrictions, appetite level, favorite ingredients, previous plan feedback/swaps.
2. Confirm gentle surplus calorie target.
3. Generate a complete new 7-day meal plan using the Gaining with Grace style.
4. Structure: breakfast, lunch, dinner + 2 snacks per day.
5. For each meal provide: title, full ingredients list, step-by-step instructions, estimated calories, macros if possible, prep/cook time, gentle_eating_notes (easierToEat swaps).
6. Prefer or reference recipes from the GWG library.
7. Generate a categorized grocery list with approximate quantities.
8. Output ONLY valid JSON:
{
  "week_start": "2026-06-08",
  "daily_target_kcal": 2450,
  "days": [
    {
      "day": "Monday",
      "meals": {
        "breakfast": { "title": "...", "ingredients": [...], "instructions": "...", "kcal": 520, "gentle_notes": "..." },
        ...
      }
    }
  ],
  "grocery_list": { "category": ["item (qty)", ...] }
}
9. Save to database as current plan for the user.
10. Log success/errors for the owner report.
```

## Example 2 – Weekly Plan Email / Notification Delivery
```
Every Sunday at 8:00 AM for users with a fresh plan:

- Use the saved plan JSON.
- Generate a warm, branded email (or in-app card):
  - Greeting with name
  - “Here’s your new gentle 7-day plan (~X kcal/day)”
  - Beautiful day-by-day summary (titles + kcal)
  - Link to view full interactive plan in the app
  - One-click grocery list download
- Send via connected email service.
```

## Example 3 – Daily Gentle Nudge (Optional)
```
Every morning ~7:30 AM for active users:

- Pull today’s meals from their current plan.
- Send short message:
  “Good morning! Today’s gentle plan to help you build steadily:
  Breakfast: [title]
  Tip: [one sentence from the recipe or general encouragement]”
- Link to open the full planner.
```

## Example 4 – Owner Weekly Report (Usage & Health)
```
Every Sunday evening:

Summarize for you (the owner):
- New signups this week
- Active users / retention
- Most used recipes / swaps
- Any generation errors or low-quality plans flagged
- Revenue / subscription changes
- Suggested improvements for next week’s prompts
Output as a clean email or dashboard card.
```

## Additional Notes for Hermes
- Always stay in GWG voice.
- When user has low appetite, heavily favor recipes that have `easierToEat` sections.
- Make plans varied and comforting (use the 18+ seed recipes + generate new ones when needed).
- Support swaps: if user swaps a meal, record it and bias future plans.
- For onboarding answers, map directly into the profile fields used in the prompt.

Copy these prompts into your Hermes cron/jobs.json or runner scripts. Start with the Weekly Plan Refresh + Delivery.

Next steps after MVP: pantry integration, PDF export, real Hermes API calls from the client instead of the demo generator.