over-50s-health

Over-50s Health Advisor

A Claude Code Agent definition for evidence-based, age-appropriate health, fitness, nutrition, and longevity guidance for adults 50+. The agent works with local context files only and always recommends confirming advice with a healthcare professional.

Features

• Evidence-based guidance with citations and a Sources section
• Safety boundaries and red-flag referral policy
• Local context management via Markdown files
• Install via Claude Code plugin system (/plugin install over-50s-health@ali5ter)
• Automatic context file creation on first run

Repository structure

This repository contains the agent definition and context templates for distribution. When installed via the plugin system, the agent is managed by Claude Code and your personal context files are stored in your home directory.

agents/
  advisor.md                       # Agent definition (source)
context/
  templates/                       # Reference context templates
    INITIAL_USER_INFORMATION.md
    CLIENT_HEALTH_CONTEXT.md
    CLIENT_PREFERENCES.md
    SESSION_NOTES.md
    SOURCES.md
  README.md
.claude-plugin/
  plugin.json                      # Plugin manifest
hooks/
  hooks.json                       # SessionStart hook (template sync)
hooks-handlers/
  sync-templates.sh                # Copies templates from plugin cache to ~/.claude/over-50s-health-advisor/templates/
migrate                            # Migration script for v2.x users
README.md
LICENSE

After installation, your personal context files are stored at:

~/.claude/over-50s-health-advisor/
    context/                       # Your personal context files (auto-created on first run)
        ├── INITIAL_USER_INFORMATION.md
        ├── CLIENT_HEALTH_CONTEXT.md
        ├── CLIENT_PREFERENCES.md
        ├── SESSION_NOTES.md
        └── SOURCES.md

Requirements

• Claude Code CLI v2.0.73 or later
• Uses Claude Opus 4.6 by default for highest reasoning quality; override with /model if preferred

Install

Inside Claude Code, run:

/plugin marketplace add ali5ter/claude-plugins
/plugin install over-50s-health@ali5ter

The first time you start a health conversation, the agent automatically creates your context files at ~/.claude/over-50s-health-advisor/context/.

Uninstall

Inside Claude Code, run:

/plugin uninstall over-50s-health@ali5ter

This removes the plugin and agent. Your personal context files are not removed. To delete them:

rm -rf ~/.claude/over-50s-health-advisor

Migrating from v2.x

If you previously installed via ./install.sh, run the migration script from this repo:

./migrate

This removes the old manually-installed agent file. Your context files are preserved. Then install via the plugin commands above.

Usage

After installation, context files are automatically created at ~/.claude/over-50s-health-advisor/context/ on your first conversation.

1. Fill in ~/.claude/over-50s-health-advisor/context/INITIAL_USER_INFORMATION.md and CLIENT_PREFERENCES.md with your information.
2. Keep CLIENT_HEALTH_CONTEXT.md and SESSION_NOTES.md current as new information is shared with the agent.
3. Maintain SOURCES.md as a curated reference list (the agent will add sources; you can remove low-quality ones and add high-quality evidence).
4. Use the agent from any directory in Claude Code. The agent will read and update these context files automatically.
5. Keep the "Last updated" dates accurate in each file.

Invoking the Agent

The health advisor agent is invoked automatically when you ask a health-related question in Claude Code. You can also target it directly using the --agent flag:

claude --agent over-50s-health:advisor

This sets the agent as the preferred delegate for the session. Claude Code routes health and wellness queries to it automatically; for anything else, the default assistant responds.

Alternatively, just start Claude Code normally and ask a health question — the agent will activate based on your query.

Starting a Conversation

When you send your first message (even just "Hi"), the agent reads your context files and greets you with a brief summary of your current health focus. If context files are missing, it will create them and prompt you to fill in your initial information.

Once you've filled in your initial context files, you can begin interacting with the agent. Here are some ways to start:

Initial Engagement:

• "Where do you see the context files?" — the agent will analyze your context and provide a summary of your health profile, helping establish rapport.
• "Can you review my health information and suggest areas to focus on?"
• "What do you know about me so far?"

Direct Queries: