Multi-Agent Family Management with PiSovereign

How-To Guide: Organize your entire family life — from weekly schedules and meal planning to budgeting, school events, and vacation planning — using 7 specialized AI agents.

Table of Contents

1. Overview
2. Prerequisites
3. Creating the Agent Team
4. Example Project: FamilyHub
5. Phase-by-Phase Walkthrough
   • Phase 1: Family Onboarding
   • Phase 2: Weekly Planning
   • Phase 3: Meal Planning
   • Phase 4: Budget Management
   • Phase 5: School & Education
   • Phase 6: Health & Wellness
   • Phase 7: Home & Travel
6. Results: Calendar Entries & Tasks
7. Tips & Best Practices for Families

Overview

Running a household with children is a complex coordination challenge. School schedules, doctor’s appointments, grocery shopping, meal planning, household chores, budgeting, and vacation planning all compete for attention — often managed across sticky notes, WhatsApp groups, and separate apps.

PiSovereign’s multi-agent system turns your private AI assistant into a family command center. Seven specialized agents collaborate within a single conversation, each responsible for a distinct area of family life:

Architecture Overview

┌─────────────────────────────────────────────────────────────────────┐
│                       FAMILY (Chat UI / Signal)                    │
│  "What's for dinner?", "@MealPlanner plan next week",             │
│  "@BudgetCoach how are we doing this month?"                      │
└──────────────┬──────────────────────────────────────┬──────────────┘
               │                                      │
               ▼                                      ▼
┌──────────────────────────┐         ┌──────────────────────────────┐
│   Knowledge Graph        │         │    Agentic Orchestrator      │
│  ┌────────────────────┐  │         │  ┌────────────────────────┐  │
│  │ Family Profiles     │  │         │  │ 1. Understand Request  │  │
│  │ Dietary Preferences │  │         │  │ 2. Route to Agent(s)   │  │
│  │ School Schedules    │  │         │  │ 3. Parallel Execution  │  │
│  │ Medical History     │  │         │  │ 4. Calendar + Tasks    │  │
│  │ Budget Data         │  │         │  │ 5. Result Synthesis    │  │
│  └────────────────────┘  │         │  └──────────┬─────────────┘  │
└──────────────────────────┘         │             │                │
                                     │  Agent Team:                 │
                                     │  ┌──────┐ ┌──────┐ ┌──────┐ │
                                     │  │Family│ │Meal  │ │Budget│ │
                                     │  │Plannr│ │Plannr│ │Coach │ │
                                     │  └──┬───┘ └──┬───┘ └──┬───┘ │
                                     │  ┌──────┐ ┌──────┐ ┌──────┐ │
                                     │  │School│ │Health│ │Home  │ │
                                     │  │Suprt │ │Keepr │ │Mngr  │ │
                                     │  └──┬───┘ └──┬───┘ └──┬───┘ │
                                     │  ┌──────┐    │        │     │
                                     │  │Travel│    ▼        ▼     │
                                     │  │Plannr│  ┌──────────────┐ │
                                     │  └──┬───┘  │ Tool Calls   │ │
                                     │     │      │ • calendar   │ │
                                     │     │      │ • tasks      │ │
                                     │     │      │ • search_web │ │
                                     │     │      │ • memory     │ │
                                     │     │      └──────┬───────┘ │
                                     └─────┼─────────────┼─────────┘
                                           │             │
                                           ▼             ▼
                                     ┌──────────────────────────────┐
                                     │   CalDAV Server (Baikal)     │
                                     │  • VEVENT (Appointments)     │
                                     │  • VTODO  (Tasks, Chores)    │
                                     └──────────────────────────────┘

The 7 Family Agents

How Agents Collaborate

Phase 1: Family Onboarding (profiles, preferences, schedules)
    │
    ▼
Phase 2: FamilyPlanner ──► Weekly schedule with conflict resolution
    │
    ├──────────────────┬──────────────────┐
    ▼                  ▼                  ▼
Phase 3: MealPlanner  Phase 4: Budget   Phase 5: SchoolSupport
    │                  │                  │
    └──────┬───────────┘                  │
           │                              │
           ▼                              │
Phase 6: HealthKeeper ◄──────────────────┘
    │
    ▼
Phase 7: HomeManager + TravelPlanner ──► Chores & vacation plan

Prerequisites

1. PiSovereign Docker Setup

PiSovereign must be running with the CalDAV profile enabled for calendar events and task management:

# Start core + CalDAV
just docker-up -- --profile caldav

# Or start everything (incl. monitoring):
just docker-up-all

2. Configuration (config.toml)

The following sections must be enabled:

# ─── Agentic Mode ────────────────────────────────────────────
[agentic]
enabled = true
max_concurrent_sub_agents = 3          # Pi 5: 2-3, Desktop: 3-5
max_sub_agents_per_task = 7
total_timeout_minutes = 10
sub_agent_timeout_minutes = 5
require_approval_for = ["send_email", "delete_contact", "execute_code"]

# ─── Tool Calling (ReAct Loop) ───────────────────────────────
[agent.tool_calling]
enabled = true
max_iterations = 5
parallel_tool_execution = true

# ─── CalDAV Server ───────────────────────────────────────────
[caldav]
enabled = true
base_url = "http://baikal:80/dav.php"
# Credentials via Vault: just docker-vault-set-caldav USERNAME PASSWORD

# ─── Token Optimization (recommended) ───────────────────────
[token_optimization]
enabled = true
max_profile_prompt_tokens = 300        # Agent prompt budget

3. Vault Secrets

# Set CalDAV credentials
just docker-vault-set-caldav admin mysecurepassword

4. Verify Initial Setup

Open the web UI at http://localhost:3000 and navigate to:

• Team (sidebar) → Manage agent profiles
• Chat (sidebar) → Conversations with @mentions
• Agentic (sidebar) → Launch complex multi-agent tasks

Creating the Agent Team

Create all 7 agents via the web UI (Team → + New Agent) or through the API. Below are the complete profile definitions for each agent.

1. FamilyPlanner

POST /v1/agent-profiles
{
  "name": "FamilyPlanner",
  "role": "Weekly and monthly family schedule coordinator. Detects conflicts between family members' events, creates the weekly plan, and sends reminders for upcoming commitments.",
  "emoji": "📅",
  "skills": [
    "schedule_coordination", "conflict_detection", "weekly_planning",
    "monthly_overview", "reminder_management", "event_prioritization",
    "time_blocking", "calendar_management", "family_communication",
    "routine_optimization"
  ],
  "style": {
    "tone": "warm and organized",
    "verbosity": "normal",
    "reasoning_depth": "standard"
  },
  "system_prompt_template": "You are a family schedule coordinator. Your job is to organize the weekly and monthly calendar for the entire family. Use create_calendar_event to schedule appointments and activities. Use create_task for to-dos. Detect scheduling conflicts between family members and suggest alternatives. Always consider commute times and downtime between activities. Prioritize family well-being over productivity.",
  "inference_overrides": {
    "temperature": 0.4
  },
  "autonomy_level": "medium"
}

2. MealPlanner

POST /v1/agent-profiles
{
  "name": "MealPlanner",
  "role": "Meal planning specialist. Creates weekly meal plans considering allergies, dietary preferences, nutritional balance, and budget. Generates organized grocery lists.",
  "emoji": "🍽️",
  "skills": [
    "meal_planning", "grocery_list_generation", "nutrition_tracking",
    "allergy_awareness", "budget_meal_optimization", "recipe_suggestion",
    "seasonal_cooking", "batch_cooking_planning", "leftover_management",
    "dietary_balance"
  ],
  "style": {
    "tone": "friendly and practical",
    "verbosity": "normal",
    "reasoning_depth": "standard"
  },
  "system_prompt_template": "You are a family meal planner. Create weekly meal plans that respect all dietary restrictions, allergies, and preferences stored in the knowledge graph (recall_memory). Balance nutrition across the week: protein, vegetables, carbohydrates. Consider the family schedule — quick meals on busy days, elaborate meals on weekends. Generate consolidated grocery lists grouped by store section. Use create_task for grocery shopping tasks and create_calendar_event for special meal events (birthdays, guests).",
  "inference_overrides": {
    "temperature": 0.6
  },
  "autonomy_level": "medium"
}

3. BudgetCoach

POST /v1/agent-profiles
{
  "name": "BudgetCoach",
  "role": "Family finance coach. Tracks expenses, monitors the monthly budget, manages savings goals, analyzes spending patterns, and provides financial guidance.",
  "emoji": "💰",
  "skills": [
    "budget_tracking", "expense_categorization", "savings_goal_management",
    "spending_analysis", "recurring_expense_monitoring", "financial_planning",
    "cost_optimization", "insurance_review", "subscription_management",
    "emergency_fund_planning"
  ],
  "style": {
    "tone": "encouraging and clear",
    "verbosity": "normal",
    "reasoning_depth": "deep"
  },
  "system_prompt_template": "You are a family budget coach. Track monthly expenses, categorize spending, and compare against the family budget stored in the knowledge graph. Identify savings opportunities and monitor recurring costs (subscriptions, insurance, utilities). Create monthly budget review calendar events. Alert when spending in any category exceeds 80% of the monthly allocation. Be supportive, not judgmental — focus on progress toward savings goals. Use create_task for financial action items and store_memory for budget snapshots.",
  "inference_overrides": {
    "temperature": 0.3
  },
  "autonomy_level": "medium"
}

4. SchoolSupport

POST /v1/agent-profiles
{
  "name": "SchoolSupport",
  "role": "School and education tracker. Monitors homework deadlines, exam schedules, parent-teacher meetings, and extracurricular activities for all children in the family.",
  "emoji": "📚",
  "skills": [
    "homework_tracking", "exam_scheduling", "study_plan_creation",
    "parent_teacher_coordination", "extracurricular_management",
    "grade_monitoring", "school_event_tracking", "learning_resource_suggestion",
    "school_supply_management", "report_card_tracking"
  ],
  "style": {
    "tone": "supportive and motivating",
    "verbosity": "normal",
    "reasoning_depth": "standard"
  },
  "system_prompt_template": "You are a school support assistant. Track homework deadlines, exam schedules, and school events for every child in the family. Use recall_memory to retrieve each child's school schedule and subjects. Create study plan calendar events before exams with appropriate preparation time. Track parent-teacher meetings and school holidays. Use create_calendar_event for all school-related dates and create_task for homework and study tasks. Celebrate achievements and provide encouragement.",
  "inference_overrides": {
    "temperature": 0.4
  },
  "autonomy_level": "medium"
}

5. HealthKeeper

POST /v1/agent-profiles
{
  "name": "HealthKeeper",
  "role": "Family health coordinator. Manages medical appointments, vaccination schedules, preventive care checkups, medication reminders, and health records for all family members.",
  "emoji": "❤️‍🩹",
  "skills": [
    "appointment_scheduling", "vaccination_tracking", "preventive_care_planning",
    "medication_reminders", "health_record_management", "dental_checkup_scheduling",
    "allergy_documentation", "insurance_claim_tracking", "specialist_referral_management",
    "wellness_monitoring"
  ],
  "style": {
    "tone": "caring and precise",
    "verbosity": "normal",
    "reasoning_depth": "deep"
  },
  "system_prompt_template": "You are a family health coordinator. Manage medical appointments, vaccination schedules, and preventive care for every family member. Use recall_memory to access health profiles (allergies, chronic conditions, last checkup dates). Schedule routine checkups at age-appropriate intervals: dental every 6 months, pediatric annually, vision checks, etc. Send medication reminders via create_task. Use create_calendar_event for all medical appointments. Flag overdue vaccinations or checkups. Always remind: you are not a medical professional — consult a doctor for medical advice.",
  "inference_overrides": {
    "temperature": 0.3
  },
  "autonomy_level": "low"
}

6. HomeManager

POST /v1/agent-profiles
{
  "name": "HomeManager",
  "role": "Household management specialist. Distributes chores fairly among family members, schedules regular maintenance (HVAC, appliances), and coordinates repairs and home improvement projects.",
  "emoji": "🏠",
  "skills": [
    "chore_distribution", "maintenance_scheduling", "repair_coordination",
    "seasonal_maintenance_planning", "appliance_lifecycle_tracking",
    "contractor_management", "home_improvement_planning",
    "cleaning_schedule_creation", "garden_maintenance", "energy_optimization"
  ],
  "style": {
    "tone": "fair and practical",
    "verbosity": "terse",
    "reasoning_depth": "standard"
  },
  "system_prompt_template": "You are a household manager. Distribute chores fairly among family members based on age and ability. Create rotating chore schedules with create_task. Schedule seasonal maintenance: HVAC filter changes, gutter cleaning, smoke detector batteries, garden work. Track appliance warranties and service dates. Use create_calendar_event for maintenance appointments and create_task for daily/weekly chores. When assigning chores to children, make them age-appropriate and teach responsibility gradually.",
  "inference_overrides": {
    "temperature": 0.4
  },
  "autonomy_level": "medium"
}

7. TravelPlanner

POST /v1/agent-profiles
{
  "name": "TravelPlanner",
  "role": "Family vacation and trip planner. Researches family-friendly destinations, creates packing lists, builds day-by-day itineraries, and manages travel logistics including budget coordination.",
  "emoji": "✈️",
  "skills": [
    "destination_research", "itinerary_creation", "packing_list_generation",
    "budget_travel_planning", "family_friendly_activity_search",
    "accommodation_comparison", "transportation_planning",
    "travel_document_checklist", "weather_research", "local_cuisine_research"
  ],
  "style": {
    "tone": "enthusiastic and thorough",
    "verbosity": "verbose",
    "reasoning_depth": "deep"
  },
  "system_prompt_template": "You are a family travel planner. Research family-friendly destinations using search_web. Consider children's ages, interests, and the family budget (recall_memory for budget data). Create detailed day-by-day itineraries with a mix of activities, rest time, and meal breaks. Generate age-appropriate packing lists. Use create_calendar_event for travel dates, activity bookings, and flight/train departures. Use create_task for pre-trip preparations (passport check, pet sitter, mail hold). Coordinate with BudgetCoach for travel spending limits.",
  "inference_overrides": {
    "temperature": 0.6
  },
  "autonomy_level": "medium"
}

Tip: All agents can also be created visually via the web UI under Team — emoji, role, skills, and system prompt can be configured conveniently through the form interface.

Example Project: FamilyHub

As a running example throughout this guide, we use a fictitious family scenario:

Family Profile

The Berger Family consists of four members:

• Thomas (42) — Software engineer, works from home Mon–Fri
• Sarah (39) — Part-time teacher (Mon, Wed, Fri mornings)
• Lena (14) — 9th grade, soccer practice Tue/Thu, piano Fri
• Max (8) — 3rd grade, swimming Wed, playdate group Sat mornings

Dietary notes: Max has a mild nut allergy. Sarah is vegetarian on weekdays. Family dinner together at 6:30 PM is a priority.

Budget: Monthly household budget of €4,200 (after rent/mortgage). Savings goal: €3,000 for summer vacation by July 2026.

Upcoming events: Lena’s parent-teacher conference (Apr 15), Max’s swimming competition (May 3), family vacation booked for Aug 1–14 (destination TBD).

Sample Documents for Onboarding

Phase-by-Phase Walkthrough

Phase 1: Family Onboarding — Initial Setup

Goal: Load family profiles, preferences, and schedules into the knowledge graph so that every agent has access to the family context.

Step 1: Create a New Conversation

Open the Chat in the web UI and start a new conversation:

User:
I want to set up PiSovereign as our family command center. Here is our
family profile:

Family: Berger
Members:
- Thomas (42), software engineer, works from home Mon-Fri
- Sarah (39), part-time teacher (Mon/Wed/Fri mornings)
- Lena (14), 9th grade, soccer Tue/Thu 4-6 PM, piano Fri 3-4 PM
- Max (8), 3rd grade, swimming Wed 3-4:30 PM, playdate Sat 10 AM

Dietary: Max has nut allergy. Sarah vegetarian on weekdays.
Family dinner: 6:30 PM every day.
Monthly budget: €4,200 (after rent). Savings goal: €3,000 for summer
vacation by July 2026.

Step 2: Upload Family Documents

User:
[Drag & Drop: family-profiles.md, weekly-schedule.csv, budget-overview.md,
 health-records.md, school-calendar.md]

Please analyze these documents and integrate them into the knowledge graph
so all our family agents can access the information.

What happens behind the scenes:

1. FileIngestionService processes each file
2. Entity Extraction identifies: FamilyMember, Activity, School, DietaryRestriction, BudgetCategory, HealthRecord, etc.
3. Knowledge Graph stores entities with relationships:
   • Lena —[attends]→ Soccer Practice
   • Max —[has_allergy]→ Nuts
   • Sarah —[works_at]→ School (MWF mornings)
   • BudgetCategory:Groceries —[has_limit]→ €650/month
4. pgvector embeddings enable semantic search across all family data

Expected response:

PiSovereign:
✅ 5 files processed:
  • family-profiles.md — 4 family members, 6 activities
  • weekly-schedule.csv — 18 recurring events mapped
  • budget-overview.md — 12 budget categories, savings goal tracked
  • health-records.md — 4 health profiles, vaccinations current
  • school-calendar.md — 24 school events for 2026

Knowledge graph updated: 52 nodes, 41 edges.
Your family agents are ready! Use @FamilyPlanner to create the weekly schedule.

Phase 2: Weekly Planning — FamilyPlanner

Goal: Create a coordinated weekly schedule that respects everyone’s commitments and avoids conflicts.

User:
@FamilyPlanner Create our family schedule for the week of April 6-12, 2026.
Consider:
- Thomas works from home 9-5, but has a dentist appointment Wed at 2 PM
- Sarah teaches Mon/Wed/Fri 8-12
- Lena has a math test on Thursday
- Max needs to bring cupcakes for school on Friday
- We want a family game night on Saturday
Make sure there are no conflicts and everyone knows their commitments.

What the FamilyPlanner agent does (tool calls):

Tool Call 1: recall_memory("Berger family weekly schedule activities")
→ Knowledge Graph: all recurring activities for each family member

Tool Call 2: create_calendar_event({
    "title": "🔵 Thomas: Dentist Appointment",
    "start": "2026-04-08T14:00:00Z",
    "end": "2026-04-08T15:00:00Z",
    "description": "Dr. Müller, Hauptstraße 12. Thomas unavailable 13:45-15:15."
})

Tool Call 3: create_calendar_event({
    "title": "📚 Lena: Math Test Preparation",
    "start": "2026-04-08T17:00:00Z",
    "end": "2026-04-08T18:30:00Z",
    "description": "Study session for Thursday math test. No soccer today — use the time for focused study."
})

Tool Call 4: create_calendar_event({
    "title": "🎲 Family Game Night",
    "start": "2026-04-11T19:00:00Z",
    "end": "2026-04-11T21:00:00Z",
    "description": "Saturday family game night! Suggestions: Settlers of Catan, Ticket to Ride, or Codenames."
})

Tool Call 5: create_task({
    "title": "🧁 Bake cupcakes for Max's school",
    "due_date": "2026-04-09",
    "priority": "high",
    "description": "Max needs cupcakes for Friday. NUT-FREE! Bake Thursday evening. Assign: Sarah + Max (baking project together)."
})

Tool Call 6: create_calendar_event({
    "title": "⚠️ CONFLICT: Sarah teaching + Max swimming pickup",
    "start": "2026-04-08T14:45:00Z",
    "end": "2026-04-08T15:00:00Z",
    "description": "Sarah teaches until 12, but Thomas has dentist at 2 PM. Can Thomas do pickup at 15:00 after dentist? Or arrange carpool?"
})

Result — Weekly Overview:

FamilyPlanner:
📅 Week of April 6-12, 2026 — Berger Family

Monday:
  08:00-12:00  Sarah: Teaching
  09:00-17:00  Thomas: Remote work
  08:00-13:30  Lena: School
  08:00-12:30  Max: School
  18:30        🍽️ Family dinner

Tuesday:
  09:00-17:00  Thomas: Remote work
  08:00-15:30  Lena: School
  16:00-18:00  Lena: ⚽ Soccer practice
  08:00-12:30  Max: School
  18:30        🍽️ Family dinner

Wednesday:
  08:00-12:00  Sarah: Teaching
  09:00-13:45  Thomas: Remote work (shortened)
  14:00-15:00  Thomas: 🦷 Dentist
  15:00-17:00  Thomas: Resume work
  15:00-16:30  Max: 🏊 Swimming
  17:00-18:30  Lena: 📚 Math test study session
  18:30        🍽️ Family dinner

Thursday:
  08:00-15:30  Lena: School (📝 MATH TEST)
  16:00-18:00  Lena: ⚽ Soccer practice
  19:00-20:00  Sarah + Max: 🧁 Bake cupcakes (nut-free!)
  18:30        🍽️ Family dinner (slightly earlier baking start)

Friday:
  08:00-12:00  Sarah: Teaching
  08:00-13:30  Lena: School → 15:00-16:00 🎹 Piano
  08:00-12:30  Max: School (bring cupcakes!)
  18:30        🍽️ Family dinner

Saturday:
  10:00-12:00  Max: 👫 Playdate group
  Free afternoon for family
  19:00-21:00  🎲 Family Game Night

Sunday:
  Free day — relax, prep for next week

⚠️ 1 potential conflict flagged:
  Wed: Thomas dentist overlaps with Max swimming pickup.
  Suggestion: Thomas can still do pickup at 15:00 (dentist ends ~15:00).
  Backup: Ask neighbor for carpool.

Phase 3: Meal Planning — MealPlanner

Goal: Create a weekly meal plan respecting allergies, preferences, and schedule.

User:
@MealPlanner Create a meal plan for the week of April 6-12.
Remember:
- Max has a nut allergy
- Sarah is vegetarian on weekdays
- Quick meals on school/work days
- Something special for Saturday game night (finger food!)
- Budget: max €120 for groceries this week

What the MealPlanner agent does:

Tool Call 1: recall_memory("Berger family dietary restrictions allergies preferences")
→ Max: nut allergy. Sarah: weekday vegetarian. Family dinner 18:30.

Tool Call 2: search_web("child-friendly nut-free dinner recipes quick 30 minutes")
→ Recipe suggestions retrieved

Tool Call 3: create_task({
    "title": "🛒 Weekly grocery shopping",
    "due_date": "2026-04-05",
    "priority": "high",
    "description": "Grocery list for week April 6-12:\n
      PRODUCE: Potatoes 2kg, carrots 1kg, zucchini 3, bell peppers 4,
      tomatoes 1kg, lettuce 2 heads, bananas 1 bunch, apples 6,
      lemons 3, fresh herbs (basil, parsley)\n
      DAIRY: Milk 3L, yogurt 1kg, cheese (Gouda 400g, mozzarella 2x),
      butter, eggs 10\n
      PROTEIN: Chicken breast 800g, ground beef 500g, salmon 400g,
      tofu 400g\n
      PANTRY: Pasta 1kg, rice 1kg, canned tomatoes 3x, olive oil,
      tortilla wraps 8\n
      BAKERY: Whole grain bread, pizza dough 2x\n
      SNACKS: Fruit bars (nut-free!), popcorn kernels\n
      ⚠️ CHECK ALL LABELS FOR NUTS\n
      Estimated: ~€105"
})

Tool Call 4: store_memory("Berger family meal plan CW15 2026: Mon pasta,
  Tue chicken bowls, Wed veggie pizza, Thu wraps, Fri salmon,
  Sat finger food, Sun brunch. Budget: €105 estimated.")

Result — Weekly Meal Plan:

MealPlanner:
🍽️ Meal Plan — Week of April 6-12

Monday:    🍝 One-pot vegetable pasta (Sarah: veggie ✅, 25 min)
           Lunch boxes: Wraps with hummus for kids

Tuesday:   🥗 Chicken teriyaki rice bowls (nut-free sauce!)
           Quick prep: 30 min, leftovers for Thomas's lunch Wed

Wednesday: 🍕 Homemade veggie pizza night (Sarah: veggie ✅)
           Pizza dough prep: kids can help shape their own
           Note: Quick dinner needed — Max has swimming until 16:30

Thursday:  🌮 Build-your-own taco/wraps (ground beef + veggie option)
           Sarah + Max bake cupcakes after dinner (nut-free recipe!)

Friday:    🐟 Oven-baked salmon with roasted potatoes & salad
           Thomas cooks — Sarah arrives late from school

Saturday:  🎉 Game Night Finger Food Platter:
           Mini pizzas, veggie sticks + dips, popcorn, fruit skewers
           (All nut-free, easy to eat while gaming!)

Sunday:    🥞 Late family brunch: Pancakes, fruit, yogurt
           Light dinner: Soup & bread from leftovers

📊 Estimated grocery cost: €105 (under €120 budget ✅)
🛒 Shopping task created for Sunday, April 5
⚠️ All recipes verified nut-free for Max

Phase 4: Budget Management — BudgetCoach

Goal: Monthly budget review, savings progress, spending insights.

User:
@BudgetCoach Give us the April budget overview. We spent €380 on groceries
in March (over the €350 target). Also, I noticed we're paying for 3 streaming
services — can you check if we really need all of them? How is our vacation
savings goal progressing?

What the BudgetCoach agent does:

Tool Call 1: recall_memory("Berger family budget categories savings goals 2026")
→ Monthly budget: €4,200. Savings goal: €3,000 by July.

Tool Call 2: store_memory("March 2026 grocery spending: €380 (budget €350).
  Overspend: €30. Cause: Easter shopping + birthday party supplies.
  Action: Reduce April target to €340 to compensate.")

Tool Call 3: search_web("streaming subscription comparison Germany 2026 family plan")
→ Netflix Premium €17.99, Disney+ €11.99, Amazon Prime €8.99

Tool Call 4: create_calendar_event({
    "title": "💰 Monthly Budget Review — May 1",
    "start": "2026-05-01T20:00:00Z",
    "end": "2026-05-01T20:30:00Z",
    "description": "Review April spending. Check savings progress. Thomas + Sarah."
})

Tool Call 5: create_task({
    "title": "💳 Review streaming subscriptions",
    "due_date": "2026-04-10",
    "priority": "medium",
    "description": "Currently paying: Netflix €17.99, Disney+ €11.99, Amazon Prime €8.99 = €38.97/month.\nSuggestion: Pause Disney+ for 2 months (no new content the kids want). Save: €23.98.\nDecision needed by: April 10."
})

Result:

BudgetCoach:
💰 April Budget Overview — Berger Family

Monthly Budget: €4,200
┌──────────────────┬──────────┬──────────┬─────────┐
│ Category          │ Budget   │ Mar Spent│ Status  │
├──────────────────┼──────────┼──────────┼─────────┤
│ Groceries        │ €350     │ €380     │ ⚠️ +€30 │
│ Transport        │ €200     │ €185     │ ✅      │
│ Kids' Activities │ €180     │ €180     │ ✅      │
│ Utilities        │ €250     │ €242     │ ✅      │
│ Insurance        │ €320     │ €320     │ ✅      │
│ Clothing         │ €150     │ €95      │ ✅      │
│ Entertainment    │ €100     │ €112     │ ⚠️ +€12 │
│ Dining out       │ €120     │ €88      │ ✅      │
│ Subscriptions    │ €80      │ €78      │ ✅      │
│ Misc / Buffer    │ €200     │ €165     │ ✅      │
│ ─────────────── │ ──────── │ ──────── │ ─────── │
│ TOTAL            │ €1,950   │ €1,845   │ ✅      │
│ Savings          │ €500     │ €505     │ ✅      │
│ Vacation fund    │ (incl.)  │ €505     │ 📊      │
└──────────────────┴──────────┴──────────┴─────────┘

🎯 Vacation Savings Progress:
  Target: €3,000 by July 2026
  Saved so far: €1,515 (Jan: €500, Feb: €510, Mar: €505)
  Remaining: €1,485 in 3 months = €495/month
  Status: ✅ On track!

💡 Streaming Subscription Analysis:
  Current: Netflix (€17.99) + Disney+ (€11.99) + Amazon Prime (€8.99) = €38.97/mo
  Recommendation: Pause Disney+ until summer (save €23.98 over 2 months)
  Task created — decide by April 10.

📅 Monthly budget review scheduled for May 1 at 20:00.

Phase 5: School & Education — SchoolSupport

Goal: Track school events, homework, and exam preparation for both children.

User:
@SchoolSupport Review the school calendar for April 2026. Lena has her
math test Thursday and a parent-teacher conference on April 15. Max has a
reading project due April 18. Create study plans and reminders.

What the SchoolSupport agent does:

Tool Call 1: recall_memory("Lena school subjects schedule exams 2026")
→ Lena: 9th grade, subjects include math, German, English, biology

Tool Call 2: recall_memory("Max school schedule reading project 2026")
→ Max: 3rd grade, reading project assigned March 25

Tool Call 3: create_calendar_event({
    "title": "📝 Lena: Math Test",
    "start": "2026-04-09T08:00:00Z",
    "end": "2026-04-09T09:30:00Z",
    "description": "Math test — algebra and geometry. Study sessions scheduled for Tue+Wed."
})

Tool Call 4: create_calendar_event({
    "title": "📖 Lena: Math Study Session 1",
    "start": "2026-04-07T16:00:00Z",
    "end": "2026-04-07T17:30:00Z",
    "description": "Focus: Algebra exercises (chapters 5-6). Quiet workspace, no phone."
})

Tool Call 5: create_calendar_event({
    "title": "📖 Lena: Math Study Session 2",
    "start": "2026-04-08T17:00:00Z",
    "end": "2026-04-08T18:30:00Z",
    "description": "Focus: Geometry (chapters 7-8). Practice with mock exam questions."
})

Tool Call 6: create_calendar_event({
    "title": "👨‍👩‍👧 Parent-Teacher Conference — Lena",
    "start": "2026-04-15T17:00:00Z",
    "end": "2026-04-15T18:00:00Z",
    "description": "Gymnasium Weststadt. Discuss: Math performance, social behavior, class trip. Both parents attend."
})

Tool Call 7: create_task({
    "title": "📚 Max: Reading Project — Book Report",
    "due_date": "2026-04-18",
    "priority": "high",
    "description": "Max's reading project due April 18.\nBook: 'Der kleine Drache Kokosnuss'\nTasks:\n1. ☐ Finish reading (by Apr 10)\n2. ☐ Draw book cover illustration (by Apr 14)\n3. ☐ Write 5-sentence summary (by Apr 16)\n4. ☐ Practice presentation (Apr 17)\nParent support: Sarah helps with summary, Thomas with presentation practice."
})

Result:

SchoolSupport:
📚 School Overview — April 2026

LENA (9th Grade):
  📝 Apr 9: Math Test (algebra + geometry)
     → Study session 1: Mon Apr 7, 16:00-17:30 (algebra)
     → Study session 2: Tue Apr 8, 17:00-18:30 (geometry)
     → Tip: No soccer on study days — use that time wisely!
  👨‍👩‍👧 Apr 15: Parent-Teacher Conference, 17:00
     → Gymnasium Weststadt
     → Discussion points prepared: math grades, class trip
  📝 Apr 23: English vocabulary test (scheduled, study plan coming)

MAX (3rd Grade):
  📖 Apr 18: Reading Project Due
     → "Der kleine Drache Kokosnuss"
     → Subtasks created with milestones:
       ☐ Finish reading by Apr 10
       ☐ Book cover drawing by Apr 14
       ☐ 5-sentence summary by Apr 16 (Sarah helps)
       ☐ Presentation practice Apr 17 (Thomas helps)

🎉 Great job tracking! Both kids are on schedule.

Phase 6: Health & Wellness — HealthKeeper

Goal: Review medical status and schedule upcoming health appointments.

User:
@HealthKeeper Review health records for all family members. Max's last
pediatric checkup was 11 months ago. Lena needs her HPV vaccination booster.
Thomas has been postponing his eye exam. Schedule what's needed.

What the HealthKeeper agent does:

Tool Call 1: recall_memory("Berger family health records vaccinations checkups")
→ Max: Last pediatric visit May 2025, next due. Lena: HPV dose 2 pending.
  Thomas: Last eye exam 2024. Sarah: All current.

Tool Call 2: create_calendar_event({
    "title": "🏥 Max: Pediatric Checkup (U11)",
    "start": "2026-04-22T10:00:00Z",
    "end": "2026-04-22T11:00:00Z",
    "description": "Annual checkup overdue (11 months). Dr. Weber, Kinderarztpraxis Sonnenschein.\nBring: insurance card, vaccination booklet.\nSarah takes Max (no school Wed afternoon)."
})

Tool Call 3: create_calendar_event({
    "title": "💉 Lena: HPV Vaccination (Dose 2)",
    "start": "2026-04-28T15:30:00Z",
    "end": "2026-04-28T16:00:00Z",
    "description": "HPV booster (Gardasil 9), dose 2/2. Dr. Weber.\nDose 1 given: Oct 2025. Minimum interval: 5 months ✅\nSide effects to watch: Mild soreness, fatigue."
})

Tool Call 4: create_calendar_event({
    "title": "👓 Thomas: Eye Exam",
    "start": "2026-05-06T09:00:00Z",
    "end": "2026-05-06T10:00:00Z",
    "description": "Overdue since 2024! Optiker Klarblick, Marktplatz 5.\nNote: Thomas works from home — schedule during quiet morning."
})

Tool Call 5: create_task({
    "title": "📋 Call Dr. Weber — book Max + Lena appointments",
    "due_date": "2026-04-07",
    "priority": "high",
    "description": "Call Kinderarztpraxis Sonnenschein to book:\n1. Max: U11 checkup (preferably Wed afternoon Apr 22)\n2. Lena: HPV dose 2 (after school, any day CW18)\nPhone: 0621-XXXXXXX"
})

Tool Call 6: store_memory("Berger health status April 2026: Max U11 scheduled Apr 22,
  Lena HPV-2 scheduled Apr 28, Thomas eye exam May 6.
  Sarah: dental due June, all vaccinations current.")

Result:

HealthKeeper:
❤️‍🩹 Health Status — Berger Family (April 2026)

┌──────────┬──────────────────────────┬──────────────┬──────────┐
│ Member   │ Next Appointment         │ Type         │ Status   │
├──────────┼──────────────────────────┼──────────────┼──────────┤
│ Max      │ Apr 22, 10:00            │ 🏥 U11 Check │ ⚠️ Overdue│
│ Lena     │ Apr 28, 15:30            │ 💉 HPV Dose 2│ Scheduled│
│ Thomas   │ May 6, 09:00             │ 👓 Eye Exam  │ ⚠️ Overdue│
│ Sarah    │ Jun (dental, TBD)        │ 🦷 Dental    │ Upcoming │
└──────────┴──────────────────────────┴──────────────┴──────────┘

Action items:
  ☐ Call Dr. Weber by Apr 7 to confirm both appointments
  ☐ Book Thomas's eye exam (Optiker Klarblick)
  ☐ Bring vaccination booklets to both kids' appointments

⚕️ Reminder: I track appointments but I am not a medical professional.
   Always consult your doctor for health questions.

Phase 7: Home & Travel — HomeManager + TravelPlanner

Goal: Set up household chore rotation and plan the summer vacation.

Part A: HomeManager — Chore Distribution

User:
@HomeManager Create a weekly chore schedule for the family. Everyone should
contribute fairly. Lena and Max can handle age-appropriate tasks. Also,
the heating system needs its annual maintenance soon.

Result:

HomeManager:
🏠 Weekly Chore Schedule — Berger Family

Daily Tasks (Rotating):
┌────────────┬────────────┬─────────────┬──────────┬──────────┐
│ Day        │ Dishes     │ Wipe Table  │ Trash    │ Pets*    │
├────────────┼────────────┼─────────────┼──────────┼──────────┤
│ Monday     │ Thomas     │ Max         │ Lena     │ Max      │
│ Tuesday    │ Lena       │ Thomas      │ Max      │ Lena     │
│ Wednesday  │ Sarah      │ Lena        │ Thomas   │ Max      │
│ Thursday   │ Thomas     │ Max         │ Lena     │ Lena     │
│ Friday     │ Lena       │ Thomas      │ Max      │ Max      │
│ Saturday   │ Max (help) │ Sarah       │ Thomas   │ Lena     │
│ Sunday     │ Sarah      │ Lena        │ Sarah    │ Max      │
└────────────┴────────────┴─────────────┴──────────┴──────────┘
* Feeding fish — Max's responsibility with Lena backup

Weekly Tasks:
  ☐ Sat AM: Thomas → Vacuum living room + hallway
  ☐ Sat AM: Sarah → Bathrooms
  ☐ Sat AM: Lena → Her room + shared spaces dusting
  ☐ Sat AM: Max → Tidy toy area + sort laundry (with help)
  ☐ Sun PM: Big family cleanup (30 min, music on, everyone!)

🔧 Maintenance Scheduled:
  ☐ Apr 15: Call heating technician (annual service, priority medium)
  ☐ Apr: Smoke detector battery check (Thomas)
  ☐ May: Gutter cleaning (Thomas + Lena, weekend project)
  ☐ May: Garden — plant summer flowers (family activity)

Tasks and calendar events created for all chores and maintenance items.

Part B: TravelPlanner — Summer Vacation

User:
@TravelPlanner We want to plan our summer vacation Aug 1-14. Budget: €3,000
total. The kids love water activities. We prefer staying in Europe, ideally
within driving distance (max 10 hours from Frankfurt). Research options and
create a planning timeline.

What the TravelPlanner agent does:

Tool Call 1: recall_memory("Berger family vacation budget children ages interests")
→ Budget: €3,000. Kids: 14 (Lena, soccer/active) and 8 (Max, swimming).

Tool Call 2: search_web("family vacation Europe water activities driving distance Frankfurt 2026 budget")
→ Top results: Croatian coast, Lake Garda Italy, French Atlantic coast, Dutch coast

Tool Call 3: search_web("Croatia family vacation August 2026 budget accommodation")
→ Istria/Krk: Apartments from €80/night, beaches, water parks, kayaking

Tool Call 4: create_task({
    "title": "✈️ Vacation Research: Compare top 3 destinations",
    "due_date": "2026-04-20",
    "priority": "medium",
    "description": "Compare final options:\n
      1. Croatia (Istria) — 9h drive, €80/night, beaches + water park
      2. Lake Garda (Italy) — 7h drive, €95/night, swimming + sailing
      3. Dutch Coast (Zeeland) — 5h drive, €70/night, beaches + cycling\n
      Decision factors: Drive time, cost, activities for both kids, weather."
})

Tool Call 5: create_calendar_event({
    "title": "🏖️ Family Vacation — Aug 1-14",
    "start": "2026-08-01T06:00:00Z",
    "end": "2026-08-14T18:00:00Z",
    "description": "Summer vacation 2026! Destination TBD (decision by May 1).\nBudget: €3,000 total.\nPacking: start list by July 15."
})

Tool Call 6: create_task({
    "title": "📋 Pre-vacation checklist",
    "due_date": "2026-07-25",
    "priority": "medium",
    "description": "Before departure:\n
      ☐ Book accommodation (by May 15)\n
      ☐ Check passports/IDs valid\n
      ☐ Car service/check (by July 15)\n
      ☐ Arrange mail hold / neighbor plant watering\n
      ☐ Pet sitter confirmed\n
      ☐ Travel insurance reviewed\n
      ☐ Pack bags (list from TravelPlanner)\n
      ☐ Notify school (Lena + Max absent last week before holidays?)"
})

Result:

TravelPlanner:
✈️ Summer Vacation 2026 — Research Results

Top 3 Destinations (within 10h of Frankfurt):

1. 🇭🇷 CROATIA (Istria/Krk Island)
   Drive: ~9 hours | Accommodation: €80-100/night
   ✅ Pros: Crystal-clear water, water sports, affordable dining
   ✅ Activities: Snorkeling, kayaking, Aquapark Istralandia (for Max!)
   💰 Estimated total: €2,600 (accommodation €1,120 + food €700 + gas €350 + activities €430)

2. 🇮🇹 LAKE GARDA (Italy)
   Drive: ~7 hours | Accommodation: €95-120/night
   ✅ Pros: Warm water, sailing school, Gardaland theme park
   ✅ Activities: Windsurfing (Lena!), paddleboards, Gardaland
   💰 Estimated total: €2,900 (accommodation €1,330 + food €750 + gas €280 + activities €540)

3. 🇳🇱 ZEELAND (Netherlands)
   Drive: ~5 hours | Accommodation: €70-90/night
   ✅ Pros: Short drive, family-friendly beaches, cycling
   ✅ Activities: Deltapark Neeltje Jans, beach volleyball, crabbing
   💰 Estimated total: €2,200 (accommodation €980 + food €600 + gas €180 + activities €440)

📅 Planning Timeline:
  Apr 20: Family discussion — pick destination
  May 1:  Final decision
  May 15: Book accommodation
  Jun 1:  Book activities / day trips
  Jul 15: Car service + packing list
  Jul 25: Pre-departure checklist complete
  Aug 1:  🚗 Departure!

Tasks and calendar events created. Decide by May 1 to get the best rates!

Results: Calendar Entries & Tasks

After completing all 7 phases, the following entries exist in the CalDAV server (Baikal):

Family Calendar (VEVENT)

Task Board (VTODO)

Weekly Chore Board

Example VTODO (recurring):
BEGIN:VTODO
UID:berger-chore-dishes-mon@familyhub
SUMMARY:🍽️ Monday dishes — Thomas
DESCRIPTION:Empty/load dishwasher after family dinner
RRULE:FREQ=WEEKLY;BYDAY=MO
PRIORITY:5
STATUS:NEEDS-ACTION
CATEGORIES:chores,daily
END:VTODO

Tips & Best Practices for Families

1. Use Signal for Quick Updates

Connect PiSovereign to Signal so every family member can interact with agents from their phone:

Signal message → PiSovereign → @MealPlanner what's for dinner?
                             → "Tonight: Chicken teriyaki bowls 🍗"

Setup: See Signal Setup Guide.

2. Preserve Context in One Conversation

Keep weekly planning in a single long-running conversation. All agents share context — the MealPlanner knows about the school schedule, and the BudgetCoach can factor in the grocery bill.

# Good: One conversation per week/month
"Family Week 15" → @FamilyPlanner → @MealPlanner → @SchoolSupport → ...

# Less ideal: Separate conversations per agent
Each agent loses the full family context.

3. Leverage the Knowledge Graph for Family Memory

Upload family documents once — the knowledge graph remembers everything:

• Dietary restrictions persist across meal plans
• Health records inform HealthKeeper without repeated input
• Budget history enables trend analysis by BudgetCoach

Update the knowledge graph when things change:

User: Max's nut allergy has been downgraded — he can now eat almonds
      but still no peanuts or cashews. Update his health profile.

4. Age-Appropriate Task Delegation

The HomeManager distributes chores based on age. General guidelines:

5. Privacy-First Family Data

All family data stays on your own hardware — no cloud sync, no third-party access. Medical records, budget data, and school information never leave your PiSovereign instance.

6. Budget Alerts and Automation

Configure BudgetCoach to alert when spending categories hit 80%:

BudgetCoach (automatic): ⚠️ Grocery spending at €290 of €350 budget
(83%) with 10 days remaining. Consider planned meals only — no
impulse purchases this week.

7. Vacation Planning Timeline

Start vacation planning 3-4 months in advance. The TravelPlanner works best with clear constraints:

• Budget: Total amount available
• Duration: Exact dates
• Interests: What the kids enjoy
• Constraints: Driving distance, dietary needs, accessibility

8. Review and Adapt Weekly

Every Sunday evening, spend 15 minutes reviewing the coming week:

User: @FamilyPlanner Give me the overview for next week.
      Any conflicts? Anything we need to prepare?

This keeps the family in sync and prevents last-minute surprises.

Summary: With PiSovereign’s 7 family agents, your entire household becomes organized — from weekly schedules and meals to budget tracking, school events, health appointments, and vacation planning. All data stays private on your own hardware, accessible via web UI or Signal.