setup

name	setup
description	First-time setup for your health tracking system. Run this when you first clone the repo. Triggers on "setup", "get started", "initialize", "onboarding", or first interaction with an empty project.

Interactive Setup

First-time onboarding wizard. Creates your personalized health profile, medications, domains, and daily tracking template.

Workflow

digraph setup {
  "Welcome" -> "Basic Info";
  "Basic Info" -> "Health Conditions";
  "Health Conditions" -> "Medications";
  "Medications" -> "Supplements";
  "Supplements" -> "Wearables & Tracking";
  "Wearables & Tracking" -> "Daily Tracking Metrics";
  "Daily Tracking Metrics" -> "Healthcare Providers";
  "Healthcare Providers" -> "Safety Concerns";
  "Safety Concerns" -> "Generate Files";
  "Generate Files" -> "Suggest Domains";
  "Suggest Domains" -> "Create Domains";
  "Create Domains" -> "Summary";
}

Step 1: Welcome

Display:

Welcome to HealthOS — your AI-native health tracking system.

I'll walk you through setting up your profile. This takes about 5-10 minutes.
Everything you share is stored locally in markdown files — nothing leaves your machine.

Let's start!

Step 2: Basic Info

Ask (one question at a time, conversational):

1. "What's your name?"
2. "Date of birth?" (calculate age)
3. "Height and weight?"
4. "Where do you live?" (city/country — relevant for climate, healthcare system)
5. "What do you do for work?" (relevant for posture, stress, schedule)

Step 3: Health Conditions

Ask: "What health condition(s) are you managing? Tell me in your own words — it can be anything from cancer to chronic pain to just wanting to optimize your health."

• Let user describe freely
• AI interprets and categorizes
• Confirm understanding: "So you're managing [X]. Is that right?"
• Ask about timeline: "When were you diagnosed? What treatments have you tried?"

Step 4: Medications

Ask: "What medications are you currently taking? Include the dose and when you take them."

• Parse free text into structured format
• Ask about PRN (as-needed) medications separately
• Note any recent changes

Step 5: Supplements

Ask: "Any supplements? Same format — what, how much, when."

• If they're on a complex stack, work through it systematically
• Note timing relative to meals

Step 6: Wearables & Tracking

Ask: "Do you use any health tracking devices or apps?"

• Oura Ring, Apple Watch, Whoop, Garmin, CGM, blood pressure cuff, scale, etc.
• For each: what data does it provide?
• Note: "You can add integration commands to CLAUDE.md later to pull data automatically."

Step 7: Daily Tracking Metrics

AI suggests based on condition + user customizes:

"Based on [condition], here's what I'd suggest tracking daily:"

Show suggested metrics in a table. Let user add/remove/modify.

Examples by condition:

• Cancer: treatment_day, nausea, fatigue, pain, appetite, weight, temperature
• Autoimmune: symptom_severity, flare, medication_taken, pain, fatigue
• Biohacker: sleep_score, hrv, rhr, steps, mood, energy
• Diabetes: fasting_glucose, post_meal_glucose, carbs, insulin_dose
• Universal (always include): mood (1-10), energy (1-10)

Step 8: Healthcare Providers (Optional)

Ask: "Who are your healthcare providers? (Optional — helps me understand your care team)"

• Primary care, specialists, etc.
• What each one manages

Step 9: Safety Concerns

Ask: "Any allergies, contraindications, or safety concerns I should always keep in mind?"

• Drug allergies
• Conditions that affect what supplements are safe
• Dietary restrictions
• Things to always check before suggesting interventions

Generate Files

After gathering all info, generate:

1. docs/context/me.md

Fill in the template with all gathered info:

• Basic info, family history
• Health conditions as Active Diagnoses
• Timeline from what user described
• Current setup (tracking, exercise)
• Initial baselines (if provided)

2. docs/context/stack.md

Fill in:

• Prescribed medications table
• Supplements table
• Daily routine (organized by timing)
• Administration notes (which need food/fat)

3. docs/context/watchlist.md

Initialize with:

• Weekly review date (next Monday)
• Monthly review date (1st of next month)
• Triggers based on condition (measurement reminders, treatment milestones)
• Lab test planning if user mentioned upcoming tests

4. PLAN.md

Initialize with:

• Current status
• Action priorities based on what user described
• Domain list

5. logs/daily/TEMPLATE.md

Generate customized version with user's chosen daily metrics in YAML frontmatter.

6. Update CLAUDE.md

Add domains to the domain loading table. Add any condition-specific safety rules to the CUSTOMIZE section.

Suggest Domains

Based on the condition, suggest 3-5 domains with rationale:

"Based on what you've told me, I'd suggest starting with these domains:"

Show table: Domain Name | Why | What You'd Track

Let user pick which ones to create. Suggest starting with 2-3, adding more later.

Create Domains

For each chosen domain:

1. Create domains/[name]/README.md from domains/TEMPLATE.md
2. Fill in "Why It Matters" based on user's condition
3. Add to domains/README.md table
4. Add initial connections to docs/context/connections.md

Summary

Show what was created:

Setup complete! Here's what I created:

Profile:     docs/context/me.md
Medications: docs/context/stack.md
Watchlist:   docs/context/watchlist.md
Health Plan: PLAN.md
Daily Log:   logs/daily/TEMPLATE.md (customized)

Domains:
  - domains/[name1]/README.md
  - domains/[name2]/README.md
  - ...

Next steps:
1. Start logging: say "log today" or /log
2. Research a topic: /research [topic]
3. Design an experiment: /experiment [intervention]
4. Add more domains: /add-domain [name]

Commit all generated files.