Agentic holistic health research framework for Claude Code.
Iterative multi-domain analysis with 9 specialists, a curated knowledge base, and graduated safety.
Getting Started · Architecture · Usage · Contributing · Roadmap · License
HolisticDrive is NOT a doctor. It is a research specialist and holistic health guide. It provides evidence-informed recommendations — never medical diagnoses or treatments.
HolisticDrive runs a three-phase pipeline:
Phase 1: Sequential Safety Pipeline
Intake → Safety Gate → Triage
Phase 2: Parallel Domain Analysis
9 domain specialists analyze simultaneously
Phase 3: Sequential Synthesis
Cross-Reference → Safety Review → Protocol Generator
- Intake — Conversational health data collection, profile management, document parsing
- Safety Gate — Graduated 3-state assessment (HALT / PROCEED WITH RESTRICTIONS / PROCEED NORMALLY)
- Triage — Routes to the appropriate domain specialists based on health profile
- Domain Specialists — 9 parallel specialists analyze different body systems
- Cross-Reference — Identifies connections and resolves conflicts across domains
- Safety Review — Final audit: herb-drug interactions, contraindications, language check
- Protocol Generator — Produces structured 9-section output with prioritized action plan
- Claude Code CLI installed
# 1. Clone this repository
git clone https://github.com/rolan86/holistic-drive.git
cd holistic-drive
# 2. Register as a local marketplace
claude plugin marketplace add ./
# 3. Install the plugin (project-scoped)
claude plugin install holistic-drive@holistic-drive-marketplace --scope project
# 4. Restart Claude Code or run /reload-pluginsTo install globally (available in all projects), use --scope user instead of --scope project.
claude plugin uninstall holistic-drive@holistic-drive-marketplace
claude plugin marketplace remove holistic-drive-marketplace| Command | Description |
|---|---|
/holistic-review |
Full holistic health analysis (new users or comprehensive review) |
/holistic-checkin |
Follow-up session — track progress and adjust your protocol |
/holistic-research <topic> |
Targeted deep dive on a specific health topic |
/holistic-status |
View current protocol snapshot |
HolisticDrive is designed for ongoing use, not one-shot analysis:
- Round 1 — Full pipeline, comprehensive assessment, "start low, go slow" (max 5 changes)
- Round N+ — Targeted follow-up: what improved, what didn't, adjust protocol
Health profiles persist locally across sessions. Each session appends to the profile history.
| Phase | Agent | Role |
|---|---|---|
| 1 | Intake | Conversational health data collection |
| 1 | Safety Gate | Danger sign detection, safety assessment |
| 1 | Triage | Domain routing and prioritization |
| 2 | Gut & Nutrition | Microbiome, digestion, nutrient analysis |
| 2 | Dietician & Culinary | Meal planning, cuisine blending, recipe adaptation |
| 2 | Hormone | Endocrine system, thyroid, cortisol, sex hormones |
| 2 | Mind | Stress, anxiety, nervous system regulation |
| 2 | Genetic | SNPs, nutrigenomics, epigenetic factors |
| 2 | Sleep | Sleep architecture, circadian rhythm |
| 2 | Immune & Inflammation | Autoimmune patterns, chronic inflammation |
| 2 | Musculoskeletal & Movement | Joint health, movement patterns, exercise |
| 2 | Ayurvedic Constitution | Dosha analysis, ritucharya, dinacharya, dravyaguna |
| 3 | Cross-Reference | Connection identification, conflict resolution |
| 3 | Safety Review | Final safety audit, interaction checking |
| 3 | Protocol Generator | Structured output generation |
| — | Orchestrator | Pipeline coordinator |
Three-layer graduated safety:
- Safety Gate (Phase 1) — Scans health profile for acute danger signs. HALT stops the pipeline entirely.
- Safety Review (Phase 3) — Cross-checks every herb recommendation against medications, contraindications, and doses.
- Language Audit — Enforces advisory language throughout. No diagnostic claims, no "will cure", no definitive statements.
Safety restrictions propagate through the entire pipeline to all downstream agents.
65 curated reference files covering:
- Interactions — Herb-drug, herb-herb, food-drug interactions and population contraindications
- Conditions — 10 condition reference cards (IBS, Hashimoto's, PCOS, insomnia, anxiety, depression, etc.)
- Ayurveda — Doshas, ritucharya, dinacharya, ahara, dravyaguna
- Herbs — 32 individual monographs + 4 category indexes
- Foods — 10 food category files with nutritional profiles and Ayurvedic context
- Health profiles stored locally in
profiles/(gitignored) - Specialist findings stored in
findings/(gitignored, per-session temp) - Knowledge base is version-controlled and human-auditable
- No data is transmitted externally
holistic-drive/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace registration
├── CLAUDE.md # Project instructions
├── .mcp.json # MCP server config (disabled by default)
├── agents/
│ ├── orchestrator.md # Pipeline coordinator
│ ├── intake.md # Health data collection
│ ├── safety-gate.md # Phase 1 safety assessment
│ ├── triage.md # Domain routing
│ ├── cross-reference.md # Conflict resolution
│ ├── safety-review.md # Phase 3 safety audit
│ ├── protocol-generator.md # Output generation
│ └── domains/ # 9 domain specialists
├── skills/
│ ├── holistic-review/ # Full analysis entry point
│ ├── holistic-checkin/ # Follow-up session
│ ├── holistic-research/ # Targeted research
│ └── holistic-status/ # Protocol snapshot
├── knowledge-base/ # Curated reference library
│ ├── interactions/ # Safety-critical interaction data
│ ├── conditions/ # Condition reference cards
│ ├── ayurveda/ # Ayurvedic knowledge
│ ├── herbs/ # Monographs + category indexes
│ └── foods/ # Food category profiles
├── profiles/ # User health profiles (gitignored)
└── findings/ # Session findings (gitignored)
HolisticDrive supports optional MCP servers for live research:
- PubMed — Biomedical literature search
- Examine.com — Supplement and nutrition evidence
- USDA Nutrition — Food composition data
MCP servers start disabled and can be enabled in .mcp.json. All domain specialists work with or without MCP (knowledge base fallback).
MIT — This project is provided for educational and research purposes only. It does not constitute medical advice.