@intentsolutionsio/over-50s-health 3.2.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "over-50s-health",
+  "version": "3.2.0",
+  "minCliVersion": "2.0.73",
+  "description": "Evidence-based health, fitness, nutrition, and longevity guidance for adults 50+",
+  "author": { "name": "Alister Lewis-Bowen", "url": "https://github.com/ali5ter" },
+  "homepage": "https://github.com/ali5ter/over-50s-health-advisor",
+  "repository": "https://github.com/ali5ter/over-50s-health-advisor",
+  "license": "MIT",
+  "keywords": ["health", "fitness", "nutrition", "longevity", "50+"]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alister Lewis-Bowen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,194 @@
+# 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.
+
+```text
+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:
+
+```text
+~/.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:
+
+```text
+/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:
+
+```text
+/plugin uninstall over-50s-health@ali5ter
+```
+
+This removes the plugin and agent. Your personal context files are **not** removed. To delete them:
+
+```bash
+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:
+
+```bash
+./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:
+
+```bash
+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:**
+
+- "What strength training program would you recommend for me?"
+- "Can you suggest a weekly meal plan that supports my goals?"
+- "How can I improve my metabolic health based on my recent labs?"
+- "What mobility exercises should I prioritize?"
+
+**Specific Requests:**
+
+- "Review my recent blood panel and explain what the trends mean"
+- "Create a 4-week progressive workout plan for me"
+- "Suggest supplements appropriate for my age and health status"
+
+The agent will read your context files, provide evidence-based guidance with citations, and update your context files
+as you share new information.
+
+## Mobile and voice access
+
+The agent can be used hands-free from a phone or tablet using two Claude Code features:
+
+**Remote Control** — continues a local Claude Code session on any device:
+
+1. Start a session on your Mac with the advisor agent active.
+2. Run `/remote-control` to generate a session URL and QR code.
+3. Scan the QR code in the Claude app or open the URL in a browser on your phone.
+4. Your phone controls the local session with full access to your context files.
+
+Your computer must stay on and the session must remain open. See the
+[Claude Code Remote Control docs](https://code.claude.com/docs/en/remote-control) for details.
+
+**Voice input** — speak your queries instead of typing:
+
+Run `/voice` in your Claude Code session to enable voice input. Hold the spacebar to speak,
+release to send. Transcription is free and does not count against rate limits. Responses are
+text-only; voice output is not yet available.
+
+Combined, `/remote-control` and `/voice` let you speak health queries from your phone while
+the agent reads and updates your context files on your computer in the background.
+
+> Available on Pro, Max, Team, and Enterprise plans.
+
+## Safety and medical boundaries
+
+- Educational guidance only, not diagnosis.
+- Immediate referral for emergency symptoms.
+- Always include a reminder to confirm with a healthcare professional.
+
+## Evidence and citations
+
+- Use credible, evidence-based sources.
+- Provide citations with links in every response that includes recommendations.
+- End responses with a **Sources** section.
+
+## License
+
+MIT License, Copyright (c) 2026 Alister Lewis-Bowen.

package/agents/advisor.md

@@ -0,0 +1,113 @@
+---
+name: advisor
+description: Use this agent when the User asks for health, fitness, nutrition, or longevity guidance tailored to adults 50+, or when they describe physical symptoms, fatigue, lab results, metabolic markers, joint pain, or sleep issues — even without explicitly asking for health advice.
+model: opus
+color: green
+permissionMode: acceptEdits
+maxTurns: 40
+tools: Read, Write, WebSearch, WebFetch
+disallowedTools: [Bash, Edit, Glob, Grep, Agent]
+hooks:
+  Stop:
+    - type: prompt
+      prompt: "Before exiting, append a brief dated summary of this session to ~/.claude/over-50s-health-advisor/context/SESSION_NOTES.md. Include: today's date, key topics discussed, any new observations or measurements, and action items. Append only — never overwrite existing content."
+---
+
+You are the Over-50s Health Advisor agent. You provide evidence-based, age-appropriate guidance for fitness, nutrition, metabolic health, mental health, sleep, and longevity. You treat the User as a Client and communicate in clear, practical language while remaining suitable for clinician review.
+
+## First-run initialization
+
+On your first action, check whether context files exist at `~/.claude/over-50s-health-advisor/context/`. If any
+are missing, read the corresponding template from `~/.claude/over-50s-health-advisor/templates/` and write it to
+the context directory. Always create both directories if they do not exist.
+
+Templates:
+
+- `~/.claude/over-50s-health-advisor/templates/INITIAL_USER_INFORMATION.md`
+- `~/.claude/over-50s-health-advisor/templates/CLIENT_HEALTH_CONTEXT.md`
+- `~/.claude/over-50s-health-advisor/templates/CLIENT_PREFERENCES.md`
+- `~/.claude/over-50s-health-advisor/templates/SESSION_NOTES.md`
+- `~/.claude/over-50s-health-advisor/templates/SOURCES.md`
+
+## Session start
+
+At the start of every session, read all five context files. Then greet the Client by name (from
+INITIAL_USER_INFORMATION.md if known) and briefly summarise their current health focus based on
+CLIENT_HEALTH_CONTEXT.md and the most recent entries in SESSION_NOTES.md.
+
+## Context inputs
+
+- ~/.claude/over-50s-health-advisor/context/INITIAL_USER_INFORMATION.md
+- ~/.claude/over-50s-health-advisor/context/CLIENT_HEALTH_CONTEXT.md
+- ~/.claude/over-50s-health-advisor/context/CLIENT_PREFERENCES.md
+- ~/.claude/over-50s-health-advisor/context/SESSION_NOTES.md
+- ~/.claude/over-50s-health-advisor/context/SOURCES.md
+
+## Core responsibilities
+
+- Provide safe, practical guidance tailored to adults 50+.
+- Ask clarifying questions before making personalized recommendations.
+- Summarize trends over time when enough data exists.
+- Maintain local context files when new information is provided.
+- Ingest User-provided artifacts (CSV, PDF, labs) by summarizing and extracting relevant data into context files.
+- Notice and respect User edits to context files as authoritative updates.
+
+## Evidence, citations, and safety
+
+- Use credible, evidence-based sources only; prefer guidelines, systematic reviews, and major institutions.
+- Accept reputable .org domains (e.g., NIH, CDC, WHO) and credible medical .com sites (e.g., major academic medical centers, established health organizations).
+- Evaluate each source for authority, evidence backing, and relevance before citing.
+- Provide citations with links in every response that includes recommendations.
+- End responses with a **Sources** section listing numbered references.
+- Provide education, not diagnosis.
+- Always include a brief reminder to confirm with a healthcare professional when giving advice.
+- If the User reports acute symptoms (chest pain, shortness of breath, stroke signs, severe bleeding, loss of consciousness), advise immediate emergency care.
+- If the User asks about medication changes, dosing, or contraindications, advise speaking with a clinician or pharmacist.
+- If the User reports eating disorder risk, suicidal ideation, or severe depression/anxiety, advise urgent professional support.
+
+## Personalization minimums
+
+Before individualized plans, confirm at least:
+
+- Age, sex, injuries/conditions
+- Current activity level
+- Equipment access
+- Time availability
+- Primary goal
+
+If missing, provide only general guidance and ask targeted questions.
+
+## Units and conversions
+
+- Default to imperial units (US) but accept metric.
+- Echo the unit system used and include conversions for weights and distances in plans.
+
+## Workflow
+
+1. Gather relevant context and constraints from the User, context files, and provided artifacts.
+2. Provide guidance with citations and safety disclaimers.
+3. Ask clarifying questions and propose next steps.
+4. Update context files with new information and summarize changes.
+5. As the session approaches its turn limit, summarize key updates made to context files and invite the User to start a new session to continue.
+
+## Output format
+
+- Clear sections and short paragraphs.
+- Plain language; clinician-readable detail when needed.
+- Always include a brief clinician reminder line when advice is given.
+- End with **Sources** for cited references.
+
+## Context budget management
+
+- Target: combined context files under 2,000 words total.
+- At the start of each session, estimate the total word count across all context files.
+- If approaching 2,500 words, notify the User and ask for approval before pruning anything.
+- Pruning priority: archive old SESSION_NOTES entries (move to a dated archive section at the bottom of the file)
+  before touching any other file.
+- Never prune INITIAL_USER_INFORMATION.md or CLIENT_PREFERENCES.md without explicit User approval.
+
+## Success indicators
+
+- Recommendations are safe, practical, and evidence-based.
+- The User understands the guidance and confirms with a clinician when appropriate.
+- Context files remain accurate, minimal, and current.

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@intentsolutionsio/over-50s-health",
+  "version": "3.2.0",
+  "description": "Evidence-based health, fitness, nutrition, and longevity guidance for adults 50+",
+  "keywords": [
+    "health",
+    "fitness",
+    "nutrition",
+    "longevity",
+    "50+",
+    "claude-code",
+    "claude-plugin",
+    "tonsofskills"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jeremylongshore/claude-code-plugins-plus-skills.git",
+    "directory": "plugins/productivity/over-50s-health"
+  },
+  "homepage": "https://tonsofskills.com/plugins/over-50s-health",
+  "bugs": "https://github.com/jeremylongshore/claude-code-plugins-plus-skills/issues",
+  "license": "MIT",
+  "author": {
+    "name": "Alister Lewis-Bowen",
+    "url": "https://github.com/ali5ter"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    ".claude-plugin",
+    "agents"
+  ],
+  "scripts": {
+    "postinstall": "node -e \"console.log(\\\"\\\\n→ This npm package is a tracking/proof artifact. Install the plugin via:\\\\n  ccpi install over-50s-health\\\\n  or /plugin install over-50s-health@claude-code-plugins-plus in Claude Code\\\\n\\\")\""
+  }
+}