Skip to content

Commit 03fc385

Browse files
Steve McMillianclaude
andcommitted
docs: Add comprehensive business context for golf course enrichment
Created /business-context/ documentation capturing Links Choice B2B business model, service offerings, customer segmentation, and enrichment requirements. Key additions: - Company profile: Processing advantage (80% look-new recycling) - Service offerings by course tier (Tier 1-4 classification) - ICP: Tier 2 Premium Private CC (sweet spot) - Qualification scoring: 10-point system - Decision hierarchy: Authority mapping by service type - Data priorities: Water hazards (anthropics#1), range size, tier - Enhanced LLM prompt template: 7 required sections Transforms enrichment from contact discovery to opportunity qualification. 🤖 Generated with Claude Code Co-Authored-By: Claude <[email protected]>
1 parent 7999558 commit 03fc385

File tree

17 files changed

+5670
-0
lines changed

17 files changed

+5670
-0
lines changed

business-context/README.md

Lines changed: 174 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,174 @@
1+
# Links Choice Business Context
2+
3+
**Last Updated:** October 31, 2025
4+
**Purpose:** Business intelligence foundation for AI-powered golf course outreach
5+
6+
---
7+
8+
## 30,000 Foot Overview
9+
10+
### Who We Are
11+
12+
**Links Choice** is a B2B golf ball processing company with a **world-class competitive advantage**: We're the only company that can remove original clear coat and reapply it, making 80% of recycled golf balls look brand new.
13+
14+
**Operating Structure:**
15+
- **Links Choice** (B2B) - Primary focus, this outreach program
16+
- **Golf Ball Nut** (B2C) - Consumer channel, future AI agent opportunity
17+
- Both operate under one federal ID
18+
19+
**Core Competency:** Golf ball processing
20+
- Recycling golf balls (remove/recoat clear coat)
21+
- Refinishing golf balls (full recoat, rebrand)
22+
- Service work for companies that can't refinish
23+
24+
---
25+
26+
## What We Sell (Green Grass Channel)
27+
28+
### High-End Courses (Country Clubs, Resorts)
29+
30+
1. **Purchase Practice Balls** - Pay them for balls they'd throw away
31+
2. **Protective Coating Service** - Extend practice ball life another season
32+
3. **Ball Retrieval Service** - Harvest balls from water hazards
33+
4. **Maintenance Ball Purchase** - Buy balls collected by grounds crews
34+
5. **Subscription Practice Program** - Swap premium range balls 2x/year
35+
36+
### Low-End Courses (Daily-Fee, Municipal)
37+
38+
1. **Retrieval Services** - Get balls from their water hazards
39+
2. **Discounted Range Balls** - 50% off new ball pricing
40+
3. **Trade Programs** - Retrieved balls = credit toward our range balls
41+
4. **Resell Packages** - Counter balls, packaged product
42+
5. **One-Stop Shop** - Practice balls + Pride/Champ accessories (tees, brushes)
43+
44+
### All Courses
45+
46+
1. **Outing Packages** - Ball + accessory bundles for corporate events
47+
48+
---
49+
50+
## Our Competitive Advantage
51+
52+
### Processing Technology
53+
**No one else in the world can do what we do:**
54+
55+
- Remove original clear coat without damaging ball
56+
- Reapply professional-grade clear coat
57+
- Result: 80% of recycled balls look brand new
58+
- Fallback: If recycling fails, refinish high-end models or convert to practice balls
59+
60+
### Business Model Benefits
61+
- **For High-End Courses:** Turn waste into revenue, better quality range balls
62+
- **For Low-End Courses:** 50% cost savings on practice balls
63+
- **For Links Choice:** Multiple revenue streams per customer (not one-time sale)
64+
65+
---
66+
67+
## Why This Matters for Outreach
68+
69+
### Current Gap
70+
The existing enrichment workflow (v1) captures:
71+
- ✅ Contact names, emails, LinkedIn
72+
- ✅ Course ownership, recent projects
73+
-**Opportunity qualification data**
74+
75+
### What We Need to Add
76+
To qualify leads properly, we need:
77+
78+
1. **Water Hazards** - Retrieval opportunity size (ponds, lakes, ball accumulation spots)
79+
2. **Course Tier** - Determines which service offering fits (pricing, rounds/year)
80+
3. **Practice Facilities** - Range size, ball quality, current supplier
81+
4. **Buying Signals** - Waste mentions, cost complaints, upcoming projects
82+
5. **Decision Authority** - Who approves contracts vs who influences vs who uses
83+
84+
---
85+
86+
## Documentation Structure
87+
88+
```
89+
business-context/
90+
├── README.md (you are here) # Start here, 30,000ft view
91+
├── v1_current_state.md # Snapshot of today's understanding
92+
93+
├── company-profile/
94+
│ ├── links-choice-overview.md # B2B business details
95+
│ ├── golf-ball-nut-overview.md # B2C (future AI work)
96+
│ ├── core-competencies.md # Processing advantage
97+
│ └── tech-stack.md # Systems we use
98+
99+
├── service-offerings/
100+
│ ├── high-end-courses.md # CC/Resort service menu
101+
│ ├── low-end-courses.md # Daily-fee/Municipal menu
102+
│ ├── all-courses.md # Universal offerings
103+
│ └── pricing-strategy.md # How we price
104+
105+
├── customer-segmentation/
106+
│ ├── ideal-customer-profile.md # What = great fit
107+
│ ├── course-tiers.md # High vs low criteria
108+
│ ├── qualification-criteria.md # Data = qualified lead
109+
│ └── disqualification-rules.md # When to skip
110+
111+
├── buyer-personas/
112+
│ ├── general-manager.md # Contract approval
113+
│ ├── superintendent.md # Maintenance, retrieval
114+
│ ├── director-of-golf.md # Range quality, pro shop
115+
│ └── decision-hierarchy.md # Authority by service
116+
117+
├── sales-process/
118+
│ ├── entry-points.md # Ways to start relationship
119+
│ ├── typical-journey.md # First service → expand
120+
│ ├── objection-handling.md # Common pushback
121+
│ └── success-metrics.md # What = qualified opp
122+
123+
└── enrichment-requirements/
124+
├── data-priorities.md # What to collect (priority order)
125+
├── workflow-mapping.md # Business needs → LLM prompts
126+
└── changelog.md # Track changes
127+
128+
```
129+
130+
---
131+
132+
## Version Control Strategy
133+
134+
**Philosophy:** Keep it simple, avoid confusion
135+
136+
- **README.md** - Always current, "start here" doc
137+
- **v1_current_state.md** - Snapshot of initial understanding (Oct 31, 2025)
138+
- **Individual files** - Living documents, update as we learn
139+
- **changelog.md** - Track major changes with dates
140+
- **No v2, v3, v4 files** - Update in place, use git for history
141+
142+
### When You Learn Something New
143+
1. Update the relevant file
144+
2. Add entry to `enrichment-requirements/changelog.md`
145+
3. DON'T create new version files
146+
147+
---
148+
149+
## Quick Reference
150+
151+
**Start Here:**
152+
- New to Links Choice? → Read this file, then `company-profile/links-choice-overview.md`
153+
- Building enrichment workflow? → `enrichment-requirements/workflow-mapping.md`
154+
- Qualifying a lead? → `customer-segmentation/qualification-criteria.md`
155+
- Talking to a contact? → `buyer-personas/[role].md`
156+
157+
**Key Files:**
158+
- Service menu: `service-offerings/` folder
159+
- Who buys what: `buyer-personas/decision-hierarchy.md`
160+
- What data to collect: `enrichment-requirements/data-priorities.md`
161+
162+
---
163+
164+
## Next Steps
165+
166+
After documenting business context:
167+
1. Enhance LLM discovery prompt with qualification fields
168+
2. Update enrichment schema for opportunity data
169+
3. Test on 3 courses to validate we're capturing the RIGHT data
170+
4. Iterate based on what we learn
171+
172+
---
173+
174+
**Current Status:** ✅ Foundation complete, ready for workflow enhancement

0 commit comments

Comments
 (0)