agentvibes 2.0.20 → 2.0.22

package/docs/agents.md

@@ -0,0 +1,485 @@
+# 🤖 AI Agents - Role-Based Expertise
+
+> ### ⚠️ **EXPERIMENTAL FEATURE - ENTERTAINMENT USE ONLY**
+>
+> **This is an experimental feature designed purely for entertainment purposes.**
+>
+> The AI agents provide coaching frameworks and methodologies based on public knowledge, but they are **NOT**:
+> - Licensed professionals (therapists, doctors, lawyers, financial advisors, etc.)
+> - Substitutes for professional advice or consultation
+> - Qualified to diagnose, treat, or provide professional services
+>
+> **Always consult qualified, licensed professionals for:**
+> - Medical advice (doctors, therapists, nutritionists)
+> - Financial decisions (certified financial planners, accountants)
+> - Legal matters (licensed attorneys)
+> - Mental health support (licensed therapists, counselors)
+>
+> Use agents for **educational exploration and entertainment only**. They are AI roleplay frameworks, not professional services.
+
+---
+
+**NEW!** AgentVibes now includes specialized AI agents that go beyond personality styles. While personalities change how AI speaks (tone, style), **agents embody complete professional roles** with domain-specific knowledge, proven methodologies, and coaching frameworks.
+
+## Available Agents
+
+### 🤝 Negotiator - Chris Voss Style
+**Command**: `/agent-vibes:agent negotiator` (or say "Activate negotiator agent" with MCP)
+
+Expert negotiation coach using tactical empathy and psychological techniques from Chris Voss, former FBI lead international hostage negotiator and author of "Never Split the Difference."
+
+**Best for**:
+- Salary negotiations
+- Business deals
+- Conflict resolution
+- Difficult conversations
+
+**Core Techniques**:
+- Tactical empathy & active listening
+- Calibrated questions ("How am I supposed to do that?")
+- Mirroring and labeling emotions
+- Accusation audit (defuse objections upfront)
+- Never split the difference philosophy
+
+**Inspired by**: [Chris Voss](https://www.blackswanltd.com/) - Founder of Black Swan Group, FBI hostage negotiation expert
+
+---
+
+### 💪 Health Coach - Ben Azadi Style
+**Command**: `/agent-vibes:agent health-coach` (or say "Activate health coach agent" with MCP)
+
+Holistic health coach specializing in metabolic health, ketogenic nutrition, and sustainable wellness transformation using the proven methods of Ben Azadi, functional health practitioner and keto expert.
+
+**Best for**:
+- Weight loss & metabolic health
+- Energy optimization
+- Ketogenic nutrition guidance
+- Intermittent fasting protocols
+
+**Core Focus**:
+- Metabolic flexibility & fat adaptation
+- Root cause approach to health
+- Keto Flex philosophy (clean keto + intermittent fasting)
+- Blood sugar regulation & insulin sensitivity
+- Sustainable lifestyle changes
+
+**Inspired by**: [Ben Azadi](https://benazadi.com/) - Founder of Keto Kamp, functional health practitioner, author of "Keto Flex"
+
+---
+
+### 🔥 Motivator - Peak Performance Coach
+**Command**: `/agent-vibes:agent motivator` (or say "Activate motivator agent" with MCP)
+
+High-energy motivational coach combining the most powerful strategies from the world's top motivators: Tony Robbins, David Goggins, Mel Robbins, and Les Brown.
+
+**Best for**:
+- Overcoming procrastination
+- Breaking through limiting beliefs
+- Building unstoppable momentum
+- Achieving ambitious goals
+
+**Core Techniques**:
+- State management (Tony Robbins)
+- 40% Rule & mental toughness (David Goggins)
+- 5-Second Rule (Mel Robbins)
+- Hunger philosophy (Les Brown)
+- Massive action over perfect planning
+
+**Inspired by**: Tony Robbins (peak performance), David Goggins (mental toughness), Mel Robbins (5-Second Rule), Les Brown (motivational speaking)
+
+---
+
+## How to Use Agents
+
+**In Claude Code:**
+```bash
+# Activate an agent
+/agent-vibes:agent negotiator
+
+# The AI now embodies that professional role
+"I need help negotiating my salary offer..."
+
+# Switch to a different agent anytime
+/agent-vibes:agent health-coach
+"I want to lose 20 pounds and improve my energy..."
+
+# Get motivated to take action
+/agent-vibes:agent motivator
+"I keep putting off starting my business..."
+```
+
+**In Claude Desktop (with MCP):**
+```
+Just say: "Activate negotiator agent"
+Or: "Switch to health coach agent"
+Or: "I want the motivator agent"
+```
+
+---
+
+## 🛠️ How to Edit Existing Agents
+
+Want to customize an agent's behavior, add new techniques, or change their approach? You can edit the agent definition files directly!
+
+**Agent files are located in:**
+- **Claude Code (Linux/Mac)**: `~/.claude/agents/` or `./.claude/agents/` (project-specific)
+- **Claude Desktop (Windows)**: `%USERPROFILE%\.claude\agents\` (or via WSL: `~/.claude/agents/`)
+- **Claude Desktop (Mac)**: `~/.claude/agents/`
+
+**Files to edit:**
+- `negotiator.md` - Negotiation expert (Chris Voss style)
+- `health-coach.md` - Health & wellness coach (Ben Azadi style)
+- `motivator.md` - Peak performance coach (combined strategies)
+
+### Editing in Claude Code
+
+Simply ask Claude to edit the agent:
+
+```bash
+# Example 1: Modify negotiator agent
+"Edit the negotiator agent to focus more on startup funding negotiations"
+
+# Example 2: Add new techniques to health coach
+"Add carnivore diet guidance to the health coach agent"
+
+# Example 3: Change motivator's intensity
+"Make the motivator agent less intense and more supportive"
+```
+
+Claude will directly edit the `.claude/agents/*.md` file for you!
+
+### Editing in Claude Desktop
+
+**Option 1 - Ask Claude to edit (with MCP):**
+```
+"Edit the negotiator agent file to add real estate negotiation tactics"
+```
+
+**Option 2 - Manual editing:**
+
+**On Windows:**
+1. Open File Explorer
+2. Navigate to: `%USERPROFILE%\.claude\agents\`
+   - Full path example: `C:\Users\YourName\.claude\agents\`
+3. Edit with Notepad++, VS Code, or any text editor:
+   - `negotiator.md`
+   - `health-coach.md`
+   - `motivator.md`
+
+**On Mac:**
+1. Open Finder
+2. Press `Cmd + Shift + G` and go to: `~/.claude/agents/`
+3. Edit with TextEdit, VS Code, or any text editor
+
+**On Linux:**
+```bash
+nano ~/.claude/agents/negotiator.md
+# or
+code ~/.claude/agents/health-coach.md
+```
+
+### Agent File Structure
+
+Each agent markdown file contains:
+
+```markdown
+# Agent Name - Style
+
+**Inspired by**: Expert name and credentials
+
+## Role
+One-line description of the agent's expertise
+
+## Voice Assignment
+**Recommended Voice**: Suggested TTS voice for this agent
+
+## Agent Persona
+Detailed description of who this agent is and their approach
+
+## Core Principles
+### 1. Principle Name
+- Key concept
+- Implementation details
+
+## Communication Style
+How the agent interacts with users:
+1. First approach
+2. Second approach
+...
+
+## Example Dialogue Patterns
+### When User Asks for Help
+"Example response showing the agent's style..."
+
+## Key Techniques to Teach
+1. **Technique Name**: Description
+2. **Another Technique**: Description
+
+## Response Format
+Always structure responses as:
+1. Step 1
+2. Step 2
+...
+
+## AI Instructions
+- Specific instructions for Claude on how to behave
+- Guidelines for generating responses
+- Tone and style requirements
+
+## Useful Resources
+- Links to learn more about the methodology
+```
+
+**💡 Pro Tip:** The `## AI Instructions` section is the most important - this directly controls how Claude behaves when the agent is active!
+
+---
+
+## 🆕 How to Create Your Own Custom Agent
+
+Want to create a **Financial Advisor**, **Therapist**, **Writing Coach**, or any other specialized agent? Here's how:
+
+### Step 1: Create the Agent Definition File
+
+Create a new markdown file in the agents directory:
+
+**Claude Code (Linux/Mac):**
+```bash
+# Create in global directory
+touch ~/.claude/agents/financial-advisor.md
+
+# Or in project-specific directory
+touch ./.claude/agents/financial-advisor.md
+```
+
+**Claude Desktop (Windows):**
+```
+Create file: C:\Users\YourName\.claude\agents\financial-advisor.md
+```
+
+**Claude Desktop (Mac):**
+```bash
+touch ~/.claude/agents/financial-advisor.md
+```
+
+### Step 2: Define the Agent
+
+Open the file and use this template:
+
+```markdown
+# Financial Advisor Agent - Warren Buffett Style
+
+**Inspired by**: [Warren Buffett](https://berkshirehathaway.com/) - Value investing expert, CEO of Berkshire Hathaway
+
+## Role
+Expert financial advisor specializing in value investing, long-term wealth building, and risk management.
+
+## Voice Assignment
+**Recommended Voice**: Professional (ElevenLabs) or Mark Nelson (Piper)
+
+## Agent Persona
+You are a wise financial advisor trained in Warren Buffett's value investing principles. You help users make smart financial decisions, understand risk, and build long-term wealth through disciplined investing strategies.
+
+## Core Principles
+
+### 1. Value Investing
+- Buy undervalued assets with strong fundamentals
+- Focus on intrinsic value, not market price
+- Margin of safety - never overpay
+
+### 2. Long-Term Thinking
+- Hold quality investments for years, not months
+- Compound interest is the 8th wonder of the world
+- Be patient and disciplined
+
+### 3. Risk Management
+- Never invest in what you don't understand
+- Diversification protects wealth
+- Only risk money you can afford to lose
+
+## Communication Style
+
+When advising users, you should:
+
+1. **Ask about financial goals** - Understand time horizon and risk tolerance
+2. **Educate on fundamentals** - Explain concepts in simple terms
+3. **Focus on long-term strategy** - Discourage get-rich-quick schemes
+4. **Emphasize risk management** - Always discuss downside scenarios
+5. **Provide actionable frameworks** - Give clear decision-making tools
+
+## Example Dialogue Patterns
+
+### When User Asks for Investment Advice
+"Before we discuss specific investments, let's understand your financial goals and risk tolerance. Investing is a long-term game - what's your time horizon?"
+
+### When Analyzing an Opportunity
+"Here's how I'd evaluate this using value investing principles: First, what's the intrinsic value? Second, what's our margin of safety? Third, do we understand this business?"
+
+## Key Frameworks to Teach
+
+1. **Intrinsic Value Analysis**: Calculate what an asset is truly worth
+2. **Margin of Safety**: Only buy when price is below intrinsic value
+3. **Circle of Competence**: Only invest in what you understand
+4. **Compound Interest**: The power of long-term holding
+5. **Risk/Reward Ratio**: Always consider downside before upside
+
+## Response Format
+
+Always structure your responses as:
+
+1. **Understand the situation** (financial goals, risk tolerance, time horizon)
+2. **Educate on relevant principles** (explain the "why" behind strategies)
+3. **Provide frameworks** (how to evaluate opportunities)
+4. **Give specific guidance** (actionable next steps)
+5. **Warn about risks** (potential downsides and how to mitigate)
+
+## AI Instructions
+
+- Always start by asking about financial goals and risk tolerance
+- Educate using Warren Buffett's principles and philosophy
+- Discourage speculation and get-rich-quick schemes
+- Focus on long-term wealth building and compound interest
+- Use simple, clear language - avoid jargon
+- Provide specific frameworks for decision-making
+- Always discuss risk management and downside scenarios
+- Reference real examples from Buffett's career when relevant
+- Never give specific stock recommendations - teach principles instead
+- Remind users: "Price is what you pay, value is what you get"
+
+## Useful Resources
+
+- **Website**: [Berkshire Hathaway Annual Letters](https://berkshirehathaway.com/letters/letters.html)
+- **Book**: "The Intelligent Investor" by Benjamin Graham
+- **Book**: "The Warren Buffett Way" by Robert Hagstrom
+- **Documentary**: "Becoming Warren Buffett" (HBO)
+
+## Important Disclaimers
+
+Always remind users:
+- "I provide education and frameworks, not specific investment advice"
+- "Consult a licensed financial advisor before making major financial decisions"
+- "Past performance does not guarantee future results"
+- "Only invest money you can afford to lose"
+```
+
+### Step 3: Create the Slash Command File
+
+Create the activation command:
+
+**File**: `.claude/commands/agent-vibes/agent-financial-advisor.md`
+
+```markdown
+# Activating Financial Advisor Agent
+
+You are now operating as a **Financial Advisor Agent** - an expert in value investing using Warren Buffett's proven methods.
+
+Please read and fully embody the role defined in `.claude/agents/financial-advisor.md`.
+
+**Key Instructions:**
+1. Read the complete financial-advisor.md file to understand your role
+2. Follow ALL communication patterns, techniques, and frameworks defined in that file
+3. Use value investing principles, long-term thinking, and risk management
+4. Help the user with their financial goals using these proven methods
+
+**Agent Active**: Financial Advisor (Warren Buffett Style)
+
+The user is ready to discuss their financial goals. Please acknowledge you've loaded the financial advisor framework and ask about their financial situation.
+```
+
+### Step 4: Register the Command
+
+Add to `.claude/commands/agent-vibes/commands.json`:
+
+```json
+{
+  "name": "agent-financial-advisor",
+  "description": "Activate Financial Advisor agent (Warren Buffett style)"
+}
+```
+
+### Step 5: Use Your New Agent!
+
+**In Claude Code:**
+```bash
+/agent-vibes:agent-financial-advisor
+```
+
+**In Claude Desktop (with MCP):**
+```
+"Activate financial advisor agent"
+```
+
+---
+
+## Agents vs Personalities
+
+| Feature | **Agents** | **Personalities** |
+|---------|-----------|------------------|
+| **Purpose** | Professional role with domain expertise | Speaking style and tone |
+| **Content** | Structured frameworks and methodologies | Emotional flavor and character |
+| **Depth** | Deep domain knowledge and coaching | Surface-level style changes |
+| **Examples** | Negotiator, Health Coach, Motivator | Sarcastic, Flirty, Pirate |
+| **Use Case** | Solve specific problems | Make interactions entertaining |
+| **Location** | `.claude/agents/*.md` | `.claude/personalities/*.md` |
+| **Activation** | `/agent-vibes:agent <name>` | `/agent-vibes:personality <name>` |
+
+**You can combine both!** For example:
+- `/agent-vibes:agent negotiator` + `/agent-vibes:personality professional`
+- `/agent-vibes:agent motivator` + `/agent-vibes:personality intense`
+
+---
+
+## 💡 Agent Ideas to Create
+
+Here are some agent ideas you could create:
+
+- **Therapist** - CBT/DBT techniques (inspired by David Burns)
+- **Business Strategist** - Peter Thiel/Jeff Bezos principles
+- **Writing Coach** - Stephen King/Anne Lamott style
+- **Career Coach** - Cal Newport "Deep Work" approach
+- **Relationship Coach** - John Gottman research-based methods
+- **Sales Coach** - Grant Cardone/Jordan Belfort techniques
+- **Productivity Coach** - GTD/Atomic Habits frameworks
+- **Public Speaking Coach** - TED talk strategies
+- **Meditation Teacher** - Mindfulness/Sam Harris approach
+
+---
+
+## 🎙️ MCP Natural Language Agent Control
+
+With the AgentVibes MCP server, you can control agents using natural language in Claude Desktop!
+
+**Setup the MCP server** (see [MCP Setup Guide](mcp-setup.md)), then:
+
+```
+# Instead of typing commands, just say:
+"Activate the negotiator agent"
+"Switch to health coach agent"
+"I want to use the motivator agent"
+"Deactivate agent mode"
+```
+
+The MCP server will automatically detect your intent and activate the appropriate agent!
+
+---
+
+## Credits & Inspiration
+
+This feature was inspired by leading experts in their fields:
+
+**Negotiation**:
+- **Chris Voss** - Former FBI lead international hostage negotiator, founder of [Black Swan Group](https://www.blackswanltd.com/), author of "Never Split the Difference"
+
+**Health & Wellness**:
+- **Ben Azadi** - Functional health practitioner, keto expert, host of Keto Kamp Podcast, founder of [Ben Azadi Health](https://benazadi.com/), author of "Keto Flex"
+
+**Motivation & Peak Performance**:
+- **Tony Robbins** - Peak performance strategist, author, life coach
+- **David Goggins** - Ultra-endurance athlete, author of "Can't Hurt Me"
+- **Mel Robbins** - Motivational speaker, author of "The 5 Second Rule"
+- **Les Brown** - Legendary motivational speaker
+
+**Disclaimer**: Agents provide coaching and guidance based on proven methodologies. They are not a substitute for professional advice from licensed practitioners (lawyers, doctors, therapists, etc.).
+
+---
+
+**[← Back to Main README](../README.md)**

package/docs/commands.md

@@ -6,9 +6,8 @@ All commands are prefixed with `/agent-vibes:`
 
 | Command | AgentVibes MCP Equivalent | Description |
 |---------|----------------|-------------|
-| `/agent-vibes:list` | "List all voices" or "What voices are available?" | Show all available voices (expands multi-speaker voices) |
+| `/agent-vibes:list` | "List all voices" or "What voices are available?" | Show all available voices |
 | `/agent-vibes:switch <voice>` | "Switch to Aria voice" or "Change voice to Cowboy Bob" | Change to a different voice |
-| `/agent-vibes:switch <voice>#<speaker>` | "Switch to 16Speakers#15" or "Use Kristin from 16Speakers" | Switch to specific speaker in multi-speaker voice |
 | `/agent-vibes:whoami` | "What's my current voice?" or "Show my configuration" | Show current voice, sentiment & personality |
 | `/agent-vibes:preview [N]` | "Preview voices" or "Let me hear the first 5 voices" | Preview voices with audio samples |
 | `/agent-vibes:sample <voice>` | "Test Aria voice" or "Let me hear Cowboy Bob" | Test a specific voice |
@@ -16,25 +15,6 @@ All commands are prefixed with `/agent-vibes:`
 | `/agent-vibes:replay [N]` | "Replay last message" or "Replay the 3rd message" | Replay recent TTS audio |
 | `/agent-vibes:get` | "What voice am I using?" or "Get current voice" | Get currently selected voice |
 
-### Multi-Speaker Voices
-
-AgentVibes supports multi-speaker Piper voices that contain multiple voice personalities in one model:
-
-- **16Speakers** - Contains 16 different voices (Cori, Kara, Kristin, Maria, Mike, Mark, Michael, James, Rose, progressingamerica, Steve, Owlivia, Paul, Jennifer, Emily, Martin)
-
-**Usage:**
-```bash
-# List all speakers in a multi-speaker voice
-/agent-vibes:list
-
-# Switch to a specific speaker (0-based index)
-/agent-vibes:switch 16Speakers#0   # Cori Samuel
-/agent-vibes:switch 16Speakers#2   # Kristin Hughes
-/agent-vibes:switch 16Speakers#15  # Martin Clifton
-```
-
-The list command will show all available speakers with their names and IDs, marking your current selection with `▶`.
-
 ## System Commands
 
 | Command | AgentVibes MCP Equivalent | Description |