geo-prospect

GEO Prospect Manager

Purpose

Manage GEO agency prospects and clients through the full sales lifecycle. All data is stored in ~/.geo-prospects/prospects.json (persistent across sessions).

---

Invocations

Invocation	What It Does
$geo-prospect new <domain>	Create new prospect (interactive prompts)
$geo-prospect list	Show all prospects with pipeline status
$geo-prospect list <status>	Filter: lead, qualified, proposal, won, lost
$geo-prospect show <id-or-domain>	Full prospect detail with history
$geo-prospect audit <id-or-domain>	Run quick GEO audit and save to prospect record
$geo-prospect note <id-or-domain> "<text>"	Add interaction note with timestamp
$geo-prospect status <id-or-domain> <new-status>	Move through pipeline
$geo-prospect won <id-or-domain> <monthly-value>	Mark as won, set contract value
$geo-prospect lost <id-or-domain> "<reason>"	Mark as lost with reason
$geo-prospect pipeline	Visual pipeline summary with revenue forecast

---

Data Structure

Each prospect is stored as a JSON record:

{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "[email protected]",
  "contact_name": "",
  "industry": "Educational Equipment Manufacturing",
  "country": "Italy",
  "status": "qualified",
  "geo_score": 32,
  "audit_date": "2026-03-12",
  "audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
  "proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
  "monthly_value": 0,
  "contract_start": null,
  "contract_months": 0,
  "notes": [
    {
      "date": "2026-03-12",
      "text": "Initial GEO quick scan. Score 32/100 - Critical tier. Strong candidate for GEO services."
    }
  ],
  "created_at": "2026-03-12",
  "updated_at": "2026-03-12"
}

---

Orchestration Instructions

$geo-prospect new <domain>

1. Check if ~/.geo-prospects/prospects.json exists, create if not (empty array)
2. Auto-detect company name from domain (e.g., electron-srl.com → Electron Srl)
3. Assign next sequential ID: PRO-001, PRO-002, etc.
4. Ask user for:
   • Contact name (optional)
   • Contact email
   • Monthly contract value estimate (optional)
5. Set status to lead
6. Save to JSON file
7. Suggest next step: "Run $geo-prospect audit electron-srl.com to score this prospect"