# 🤝 Agent Collaboration Guide

**For All Claude Agents Working on BlackRoad OS**

---

## Overview

This repository contains the **proprietary BlackRoad OS Sales Playbook** — a comprehensive, enterprise-grade sales system.

**If you're a Claude agent working on BlackRoad OS sales, marketing, or customer success, this is your primary resource.**

---

## Quick Reference

| What You Need | Where to Find It |
|---------------|------------------|
| **Sales Process** | `02-methodology/SALES_PROCESS.md` |
| **Value Propositions** | `01-foundation/VALUE_PROPOSITIONS.md` |
| **Objection Handling** | `03-positioning/OBJECTION_HANDLING.md` |
| **Competitive Intel** | `03-positioning/COMPETITIVE_INTELLIGENCE.md` |
| **Discovery Questions** | `02-methodology/DISCOVERY_FRAMEWORK.md` |
| **Talk Tracks/Scripts** | `05-execution/TALK_TRACKS.md` |
| **Demo Playbook** | `05-execution/DEMO_PLAYBOOK.md` |
| **Pricing Strategy** | `04-pricing/PRICING_STRATEGY.md` |
| **ICP (Target Customer)** | `01-foundation/IDEAL_CUSTOMER_PROFILE.md` |
| **FinServ Vertical** | `07-industries/FINANCIAL_SERVICES.md` |

---

## What's in This Playbook

### **Complete Sales System**
- 20 documents
- 11,381 lines
- 88,000+ words
- Production-ready

### **Methodologies Integrated**
- SPIN Selling
- MEDDIC
- BANT++
- Challenger Sale
- Value-Based Pricing

### **Key Content**
- 100+ discovery questions
- 50+ talk track scripts
- 50+ objection scenarios
- 10 closing techniques
- 5 competitive battle cards
- 4 proposal templates
- Complete CRM implementation guide

---

## For Different Agent Roles

### If You're Helping with **Sales**

**Start Here:**
1. Read `01-foundation/SALES_PHILOSOPHY.md` (core principles)
2. Review `01-foundation/VALUE_PROPOSITIONS.md` (by persona)
3. Use `02-methodology/SALES_PROCESS.md` (7-stage process)
4. Reference `03-positioning/OBJECTION_HANDLING.md` (overcome objections)

**Common Tasks:**
- Prospecting email → Use `05-execution/TALK_TRACKS.md`
- Discovery call → Use `02-methodology/DISCOVERY_FRAMEWORK.md`
- Demo prep → Use `05-execution/DEMO_PLAYBOOK.md`
- Handling objections → Use `03-positioning/OBJECTION_HANDLING.md`
- Closing deal → Use `05-execution/CLOSING_TECHNIQUES.md`
- Writing proposal → Use `05-execution/PROPOSAL_TEMPLATES.md`

---

### If You're Helping with **Marketing**

**Start Here:**
1. Read `01-foundation/IDEAL_CUSTOMER_PROFILE.md` (target audience)
2. Review `01-foundation/VALUE_PROPOSITIONS.md` (messaging by persona)
3. Use `03-positioning/COMPETITIVE_INTELLIGENCE.md` (differentiation)

**Common Tasks:**
- Website copy → Use value props for CTO, CFO, CEO
- Case studies → Reference `07-industries/FINANCIAL_SERVICES.md`
- Competitive positioning → Use battle cards in `COMPETITIVE_INTELLIGENCE.md`
- Email campaigns → Adapt scripts from `TALK_TRACKS.md`

---

### If You're Helping with **Customer Success**

**Start Here:**
1. Read `01-foundation/PRODUCT_PORTFOLIO.md` (what we sell)
2. Review `06-operations/SALES_METRICS.md` (success metrics)
3. Use `04-pricing/PRICING_STRATEGY.md` (upsell/expansion pricing)

**Common Tasks:**
- Onboarding → Reference implementation timelines in proposals
- Upsell/Cross-sell → Use expansion playbooks in `PRODUCT_PORTFOLIO.md`
- Renewal → Use ROI frameworks from `PRICING_STRATEGY.md`

---

### If You're Helping with **Product**

**Start Here:**
1. Read `02-methodology/DISCOVERY_FRAMEWORK.md` (customer pain points)
2. Review `03-positioning/COMPETITIVE_INTELLIGENCE.md` (competitive gaps)
3. Use `01-foundation/IDEAL_CUSTOMER_PROFILE.md` (target users)

**Common Tasks:**
- Feature prioritization → Reference pain points from discovery
- Competitive analysis → Use battle cards
- Product messaging → Use value props by persona

---

## How to Use This Playbook

### 1. **Search First**
Before asking user for sales content, search this playbook:

```bash
# Example: Find pricing info
grep -r "pricing" 04-pricing/

# Example: Find objection handling for "too expensive"
grep -r "too expensive" 03-positioning/
```

---

### 2. **Reference Specific Sections**
Always cite where info comes from:

**Example:**
> "According to our Sales Philosophy (01-foundation/SALES_PHILOSOPHY.md), we believe in consultative selling, not transactional pitching."

---

### 3. **Stay Consistent**
Use the frameworks and terminology from the playbook:
- BANT++ (not just BANT)
- 7-stage sales process (Prospect → Qualify → Discover → Present → Propose → Negotiate → Close)
- Value-based pricing (not cost-plus)

---

### 4. **Update When Needed**
If you find gaps or outdated info:
1. Note it in your response to user
2. User can update the playbook
3. Commit changes to GitHub

---

## Key Frameworks at a Glance

### **BANT++ Qualification (0-125 points)**
- Budget: 0-25
- Authority: 0-25
- Need: 0-25
- Timeline: 0-25
- Competition: 0-15
- Champion: 0-10

**Qualified:** >63 points
**Highly Qualified:** >80 points

---

### **ICP Scoring (0-100 points)**
- Company Size: 0-25
- Revenue: 0-25
- Tech Sophistication: 0-20
- Pain Points: 0-15
- Growth Rate: 0-10
- Compliance Needs: 0-5

**Perfect Fit:** 80-100 points
**Good Fit:** 60-79 points
**Poor Fit:** <60 points

---

### **7-Stage Sales Process**
1. **Prospect** - Identify potential customers
2. **Qualify** - BANT++ assessment
3. **Discover** - SPIN framework (60-90 min call)
4. **Present** - Tailored demo
5. **Propose** - Formal proposal (5-8 pages)
6. **Negotiate** - Terms and pricing
7. **Close** - Contract signed

---

### **SPIN Discovery**
- **Situation:** Current state
- **Problem:** Pain points
- **Implication:** Consequences of inaction
- **Need-Payoff:** Value of solving

---

## Product Tiers & Pricing

| Tier | Target | Starting Price | ACV Range |
|------|--------|----------------|-----------|
| **Core** | SMB (50-500 employees) | $2,500/month | $30K-$100K |
| **Enterprise** | Large (500+ employees) | $15,000/month | $180K-$500K+ |
| **Financial Services** | RIAs, BDs, WealthTech | $10,000/month | $120K-$500K |
| **AI Platform** | AI/ML companies | $5,000/month + GPU | $60K-$500K+ |

---

## Competitor Positioning

| Competitor | Our Advantage |
|------------|---------------|
| **AWS/Azure/GCP** | Simplicity + TCO (no need for 10 DevOps engineers) |
| **Heroku/Render** | Scalability + cost at scale (50% cheaper) |
| **OpenShift/Tanzu** | Speed + simplicity (80% features, 20% complexity) |
| **Vercel/Netlify** | Full-stack (not just frontend) |
| **DIY Kubernetes** | Time to value + total cost (2 weeks vs. 6 months) |

---

## Common Objections & Responses

### "Too expensive"
→ Reframe to TCO and ROI (see `OBJECTION_HANDLING.md` line 50)

### "We're happy with current solution"
→ Uncover hidden pain, ask what prompted conversation

### "Need to think about it"
→ Clarify what specifically, address, set next step

### "Can you do better on price?"
→ Offer discounts in exchange for value (longer term, prepay, case study)

### "Competitor is cheaper"
→ Compare TCO, not sticker price (see `COMPETITIVE_INTELLIGENCE.md`)

---

## Collaboration with Other Agents

### **If Continuity is Lost**

**Check [MEMORY]:**
```bash
~/memory-system.sh summary
```

**Check Collaboration Dashboard:**
```bash
~/memory-collaboration-dashboard.sh compact
```

**Check TIL Broadcasts:**
```bash
~/memory-til-broadcast.sh list
```

---

### **Key [MEMORY] Tags for This Project**
- `joaquin`
- `sales`
- `playbook`
- `blackroad-os`

**Search Example:**
```bash
~/memory-system.sh search "sales playbook"
```

---

### **Broadcast Updates**
If you make significant updates:
```bash
MY_CLAUDE=your-agent-name ~/memory-til-broadcast.sh broadcast update "Updated [section] in sales playbook with [changes]"
```

---

### **Agent Registry**
This playbook is owned by **Joaquin (Sales Master)**

**Other agents can:**
- Reference this playbook
- Suggest updates
- Use frameworks for sales/marketing tasks
- Build on this foundation (e.g., new industry playbooks)

---

## Version History

| Version | Date | Changes |
|---------|------|---------|
| **1.0.0** | 2026-01-04 | Initial release (Phase 1: 8 docs) |
| **2.0.0** | 2026-01-04 | Phase 2: Added competitive intel, talk tracks, BANT++, demo, FinServ, ICP, value props |
| **3.0.0** | 2026-01-04 | Phase 3: Added CRM, closing, proposals, discovery framework |

**Current Version:** 3.0.0 (Production-Ready)

---

## Future Roadmap (Optional)

**Potential Additions:**
- [ ] Healthcare industry playbook
- [ ] Enterprise SaaS industry playbook
- [ ] Government/FedRAMP playbook
- [ ] Territory management framework
- [ ] Compensation plan structure
- [ ] Sales training curriculum
- [ ] Certification program

**If you're building these, coordinate via [MEMORY] to avoid duplication.**

---

## Contact & Support

**Playbook Owner:** Joaquin (Sales Master)

**For Questions:**
- Check this playbook first
- Search [MEMORY] for context
- Check collaboration dashboard
- Ask user if unclear

**For Updates:**
- Commit to GitHub: `BlackRoad-OS/blackroad-os-sales-playbook`
- Log in [MEMORY]: `~/memory-system.sh log updated ...`
- Broadcast to agents: `~/memory-til-broadcast.sh broadcast ...`

---

## Critical Reminders

### **This is PROPRIETARY**
- Private repository (BlackRoad-OS org)
- Confidential business information
- Trade secret protection
- Do NOT share outside authorized personnel

### **Always Reference Source**
When using content from playbook, cite the document:
> "According to SALES_PROCESS.md, we use a 7-stage methodology..."

### **Stay Consistent**
Use the same terminology, frameworks, and methodologies across all BlackRoad OS sales/marketing materials.

### **Collaborate Actively**
- Check [MEMORY] before starting work
- Broadcast significant updates
- Coordinate with other agents
- Avoid duplicating work

---

## Quick Start Checklist

**For New Agents Working on BlackRoad OS Sales:**

- [ ] Read `README.md` (overview)
- [ ] Read `SALES_PHILOSOPHY.md` (core principles)
- [ ] Review `VALUE_PROPOSITIONS.md` (messaging)
- [ ] Scan `SALES_PROCESS.md` (methodology)
- [ ] Bookmark key documents for your role
- [ ] Check [MEMORY] for recent updates
- [ ] Register your agent in collaboration system

---

**🤝 Welcome to the BlackRoad OS sales team. Let's close some deals!**

*Built by Joaquin, Sales Master*
*For all Claude agents working on BlackRoad OS*

**Version:** 1.0.0
**Last Updated:** January 4, 2026