@elitedcs/ghl-mcp 3.71.0 → 3.72.0

package/skills/blueprint/presets/local-service.md

@@ -0,0 +1,58 @@
+# Preset: Local Service
+
+**File:** `local-service.preset.json` · **id:** `local_service` · **version:** 2.0.0 · **default:** no
+**Source:** Built from the intake industry pack "local-service" (service_area, estimate_flow, emergency_service) and the missed-call text-back pattern; v2 depth per the owner review of 2026-08-26.
+
+## When it is selected
+Routes from the "Local service" business type (and home services / contractor / trade names) and the `local_service` / `home_services` / `contractor` / `trades` 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** — "Jobs Pipeline": New Lead → Contacted → Estimate Scheduled* → Quote Sent → Job Won → Job Complete → Repeat / Maintenance → Lost. Overridden by `goal.salesStages` when the brief supplies them.
+- **7 custom fields** — Lead Source, Service Needed, Urgency, Service Address, Estimate Date*, Quote Amount, 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** — Estimate Visit (round_robin, Mon-Fri 8-18 default, 60-minute slots, `teamMemberRefs` → the plan users).*
+- **1 intake form + 1 funnel** — "Quote Request" (first/last/email/phone required + service needed + urgency + service address) and a Get a Quote opt-in page (the promise, service area, how the estimate works, A2P consent block) plus a Thank You page with the estimate 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 |
+| Estimate Booked - Confirm & Move | appointment (confirmed) | 8 | 2 | instant | no |
+| Estimate 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.
+- **Estimate Visit → 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 for a lead who is comparing three quotes on their phone. The instant text asks the only question that matters first (is it urgent?), the second asks for a photo, and every email answers a comparison question: what a written quote from us includes, why the cheapest quote costs more, the three questions to ask any contractor, what a small problem turns into. Win-back is seasonal (maintenance before the season turns). No before/after claims unless the brief supplies real ones.