@elitedcs/ghl-mcp 3.71.0 → 3.72.0

package/skills/blueprint/presets/coach.md

@@ -0,0 +1,58 @@
+# Preset: Coach / Consultant
+
+**File:** `coach.preset.json` · **id:** `coach` · **version:** 2.0.0 · **default:** no
+**Source:** Built from the intake industry pack "coach" (delivery_format, call_booking_flow) and the discovery-call sales pattern; v2 depth per the owner review of 2026-08-26.
+
+## When it is selected
+Routes from the "Coach / consultant" business type (coaching, consulting, course creator) and the `coach` / `consultant` / `coaching` / `consulting` / `course` aliases.
+
+## What it builds (skeleton, v2 depth)
+- **Users** — one per `brief.team.staff[]` entry. Every alert, task and assignment step points at a `userRef`; in the skeleton that is the role placeholder `user.owner`, resolved at fill time from `team.notifyName` (alerts) and `team.callsName` (tasks, assignment). No staff yet → the steps stay, pointed at `user.__pending__`, and the build reports them as waiting.
+- **1 pipeline** — "Client Journey": New Lead → Contacted → Call Booked* → Call Held* → Offer Made → Enrolled → Alumni / Referral → Lost. Overridden by `goal.salesStages` when the brief supplies them.
+- **6 custom fields** — Lead Source, Program Interest, Biggest Challenge Right Now, Timeline, Discovery Call Date*, Estimated Lifetime Value.
+- **24 tags** — source, lifecycle, the hand-off trigger tags (`nurture-start`, `winback-start`, `missed-call`, `no-show`), and interest tags mirrored from the interest field.
+- **4 custom values** — business_name, business_phone, owner_first_name, booking_link. Every message reads business name / phone / signature / links from these, so the copy stays right when details change.
+- **1 calendar** — Discovery Call (round_robin, Mon-Fri 10-16 default, 30-minute slots, `teamMemberRefs` → the plan users).*
+- **1 intake form + 1 funnel** — "Application" (first/last/email/phone required + program interest + biggest challenge + timeline) and an Apply / Book a Call opt-in page (the promise, who it is for and not for, what the call is, A2P consent block) plus a Thank You page with the call booking widget.
+- **15 email + 17 SMS templates** — complete, send-ready copy written to `references/copy-guide.md`. The build stage rewrites every one from the real brief (offer, pain points, objections, prices, lead magnet) and keeps the cadence, the single CTA and the merge fields.
+- **8 workflows, 32 customer touches** — see the table.
+
+\* conditional on `goal.bookingNeeded == true`.
+
+## Workflows
+
+| Workflow | Trigger | Actions | Touches | Span of waits | Stops on reply |
+|---|---|---|---|---|---|
+| Speed to Lead | form_submission | 15 | 5 | 1.1 days | yes |
+| Missed Call Text-Back | call_status (missed: no-answer/busy/voicemail) | 7 | 2 | 1 h | yes |
+| Lead Nurture (30 days) | contact_tag (tag.nurture_start) | 28 | 11 | 31 days | yes |
+| Replied - Stop & Route | customer_reply | 9 | 0 | instant | no |
+| Win-back (30 days) | contact_tag (tag.winback_start) | 13 | 5 | 31 days | yes |
+| Call Booked - Confirm & Move | appointment (confirmed) | 8 | 2 | instant | no |
+| Call Reminders | appointment (confirmed) | 5 | 3 | instant | no |
+| No-Show Rescue | appointment (noshow) | 14 | 4 | 7 days | yes |
+
+- **Speed to Lead** (15 actions): instant text + email, opportunity card, the contact assigned to whoever takes calls, alert to a real person, a call task due today, a 2nd touch at 20 minutes, a 3rd at 3 hours, a 4th and 5th by the next day, then the hand-off tag `nurture-start` as the last action.
+- **Lead Nurture** (28 actions, 11 touches, 31 days of waits): give, give, ask. Ends with `lifecycle-lapsed` + the `winback-start` hand-off.
+- **Win-back** (13 actions, 5 touches, 31 days of waits): one reason to come back per message, then `lifecycle-lost`.
+- **Replied - Stop & Route**: the exit workflow. Pulls the contact out of every sequence, notes it, marks contacted, alerts a person and creates a 15-minute reply task.
+- **Missed Call Text-Back**: `call_status` trigger scoped to no-answer / busy / voicemail, inbound. Text within seconds, tag, alert, call-back task, one more text an hour later.
+- **Discovery Call → Confirm & Move, Reminders, No-Show Rescue**: booking stops every sequence and moves (or creates) the opportunity; reminders at 24 h and 2 h; a no-show gets a same-day call task, text and email, two more touches, then hands off to Win-back and moves the card back to Contacted.
+
+### Why sequences hand off with a tag, not add_to_workflow
+Every hand-off is `add_contact_tag` + a `contact_tag` trigger. Both halves are live-proven shapes captured from working GHL workflows (`templates/action-schemas.json`). `add_to_workflow` has no captured native shape there and has not been proven at runtime, so a preset may not use it. Each sequence removes its own trigger tag as its first action so a later hand-off can start it again.
+
+## How the brief shapes it
+| Brief signal | Effect |
+|---|---|
+| `goal.salesStages` present | replaces the default pipeline stages (workflow stage refs are mapped to the nearest equivalent) |
+| `goal.bookingNeeded == false` | drops the calendar, booking stage/tag/fields, the three appointment workflows and the calendar handoffs |
+| `channels.sms == true` | keeps SMS templates, the send_sms actions, Missed Call Text-Back and the A2P gating; otherwise they drop (the email-only nurture still spans 31 days) |
+| staff answers present | fills `users`; every `userRef` resolves to a real person |
+| staff empty | every `userRef` → `user.__pending__`; the steps stay; `handoff.add_staff` holds those workflows DRAFT |
+| `flags` | `needs_a2p` / `stripe_not_connected` / `calendar_oauth_needed` / `email_domain_needed` add the matching handoff |
+| `business.name`, `offer.*`, `audience.*`, `extended.*` | fill object names, custom values and ground every template rewrite |
+
+
+## Copy notes
+Built on belief shifts, not hype: you do not need more information, you need a decision; the reason "tried before" did not stick was structure, not willpower; the call is a diagnosis, not a pitch; the cost of staying where you are. Time and money objections are handled head-on on days 14 and 20. Every text is a one-word question. No income, result or transformation claims are made; the build stage adds real client results only if the brief supplies them.