name: health-research description: Deep research on any health, biohacking, supplement, or medical topic. Triggers on "research", "what does science say", "evidence", "studies", "look into", or any request for scientific investigation of a health topic.
Health Research
Tiered research on any health topic with personalized context and proper filing.
Research Tiers
| Tier | When | Tool | Save? |
|---|---|---|---|
| Quick | Simple question, fact-check, dosing | perplexity_ask or perplexity_reason |
No |
| Standard | New topic, overview | 1x perplexity_research (wide) |
Yes |
| Deep | Before starting intervention, medical decision, anything affecting treatment | 1x wide + 3-6x narrow perplexity_research (parallel) |
Yes |
Automatic Tier Selection
| Signal | Tier |
|---|---|
| "What's the dosage of X?" / "What is X?" | Quick |
| "Research X" / "What does science say about X?" | Standard |
| "I want to start taking X" / "Is X safe for me?" | Deep |
| "Add X to my stack" / "Should I try X?" | Deep |
| User explicitly says "deep" or "thorough" | Deep |
| Topic affects current medications or conditions | Deep (always!) |
| New medication or treatment change | Deep (always!) |
When in doubt → Deep. More information is always better for health decisions.
Workflow
1. Load Context (aggressively!)
Always load ALL of these in parallel:
docs/context/me.md— profile, baselines, health conditionsdocs/context/stack.md— current stack (interactions!)docs/context/watchlist.md— what we're trackingdata/medical/README.md— lab tests, historydomains/README.md— all domains + connections map
Also load ANY domain that might be related. When in doubt, load it.
2. Check Existing Research
BEFORE running any search, check if we already have research:
ls docs/research/
If relevant file exists:
- Read it
- Check if still valid (Query Context → Validity notes)
- If valid → USE IT, don't duplicate
- If outdated (weight changed, new labs, >3 months) → run new research referencing the old
3. Build Personalized Query
EVERY query (except Quick) MUST include user context:
PROFILE: [age, sex, height, weight, BF%, key conditions]
LABS ([date], at weight [X] kg): [relevant values]
CURRENT STATUS: [weight, BF%, relevant changes since labs]
STACK: [relevant items from stack.md]
HEALTH CONDITIONS: [active diagnoses, safety concerns]
Always ask about:
- Safety for user's specific conditions
- Interactions with current medications and supplements
- Evidence in relevant population (age, sex, condition)
- Dosing, timing, safety, contraindications
4. Run Research by Tier
Quick
- 1x
perplexity_askorperplexity_reason - Answer directly, no file saved
Standard
- 1x
perplexity_research(wide query covering the full topic) - Save research file
Deep
Phase 1 — Wide: 1x perplexity_research — broad query covering the full topic
Phase 2 — Narrow (parallel): 3-6 targeted queries from this menu:
| Category | When to Include | Focus |
|---|---|---|
| Safety for conditions | Always if user has active conditions | Clinical evidence, contraindications, risk |
| Drug/supplement interactions | Always | Specific interactions with every item in stack |
| Side effects | Always for supplements/meds | GI, long-term, dose-dependent, red flags |
| Dosing details | If wide wasn't specific enough | Titration, timing, with/without food, split doses |
| Target mechanism | If relevant for specific condition | How it affects the specific health issue |
| Population-specific evidence | If user is unusual population | Evidence in their age group, condition, etc. |
Phase 3 — Cross-Check: Compare narrow results with wide. Identify agreements, contradictions, new info.
Phase 4 — Save: Merge into single research file with cross-check section.
5. Save Research File
Save to: docs/research/[domain]/YYYY-MM-DD-topic.md
Required format:
# [Topic] Research
**Date:** YYYY-MM-DD
**Tier:** Quick / Standard / Deep
**Source:** Perplexity Research
---
## Query Context
**Input query (wide):**
> "[Exact query]"
**Narrow queries (if Deep):**
> 1. "[Query 1]"
> 2. "[Query 2]"
**Key context values:**
- Weight: X kg (from date Y)
- Lab results: from YYYY-MM-DD
- [Other relevant values]
**Validity notes:**
- If X changes, section Y may be outdated
- Valid until: [condition]
---
## Executive Summary
[3-5 sentences]
## [Sections by content]
...
## Cross-Check (if Deep)
| Claim | Wide | Narrow | Match? |
|-------|------|--------|--------|
## Actionable Items
[What specifically to do]
## References
[Preserve citations from Perplexity]
6. Update Domain + Watchlist
After saving:
- Domain README — add key findings to Research section
- Watchlist — if research recommends a lab test → add to watchlist
- Connections — if cross-domain insight → check connections.md
- Stack — if research recommends new supplement → note in stack.md if user agrees
Data Integrity
Never mix data from different time periods!
If using lab results:
- Use body comp data from THAT period
- Explicitly state: "Labs from [date] at weight [X] kg"
- If things changed → note expected effect
If user provided an argument
/research magnesium → research magnesium (AI selects tier)
/research magnesium deep → force Deep tier
/research "is X safe?" → Quick tier
/research (no argument) → ask for topic