/digital-marketing-pro:pipeline-update

/digital-marketing-pro:pipeline-update

Script location. If your host does not set ${CLAUDE_PLUGIN_ROOT}, the scripts are in this plugin's scripts/ folder, next to skills/. Run them with Python 3.10 or newer: python, or python3 where python is not found (macOS, many Linux systems).

Purpose

Update deal and opportunity records in the CRM pipeline — move deals between stages, update values, add notes, and track pipeline velocity. Provides a clear before-and-after view of every change and calculates the downstream impact on pipeline metrics, giving both marketing and sales teams visibility into deal progression, forecast accuracy, and revenue pacing against targets. Designed for both individual deal updates and batch stage transitions, with built-in validation to prevent invalid stage skips and mandatory field gaps.

Use this command for pipeline changes that affect deal stage, value, or forecast. For creating new deals from leads, use /digital-marketing-pro:lead-import to bring leads into the CRM first, then use this command to manage their pipeline progression. For bulk pipeline reporting without individual updates, use /digital-marketing-pro:executive-dashboard instead.

Execution gate (MANDATORY — cannot be skipped)

1. Present the full preview — recipients / spend / changes / compliance — as an Execution Summary before touching any live system.
2. The user must type yes (or an equivalent explicit approval). ANY other input — ambiguous, implied, partial, or absent approval — cancels the run.
3. Never proceed on ambiguous input. Never auto-retry a failed execution; a failure needs human review before any re-run.
4. Only after the user types yes, record it: python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"pipeline-update","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}', then python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}. If either command errors, stop and report the error; never work around it with another tool. The record proves the approval step ran for this action; it cannot prove who typed yes.
5. Execute. A write sent through connector_executor.py needs --approval-id and fires only against a matching, unused, unexpired record (see /digital-marketing-pro:execute-action). A write through a connected MCP server tool is outside that code check: it relies on this typed yes and on your host's permission prompt. Afterwards run python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}' (or failure).

Input Required

The user must provide (or will be prompted for):

• Deal identifier: How to locate the deal — deal name, associated contact email, company name, or CRM record ID. If ambiguous, the system will present matching candidates for selection.
• Updates to apply: One or more changes — stage change (e.g., "Proposal Sent" to "Negotiation"), deal value update (increase, decrease, or split), close date adjustment, probability override, loss reason (if moving to closed-lost), or custom field modification
• Notes or context: Reason for the update, meeting summary, objection details, competitor intelligence, next steps, or any qualitative context to attach to the deal record as a timestamped note
• Pipeline name (if multiple): Which pipeline the deal belongs to — relevant for businesses with separate pipelines for new business, renewals, upsells, partnerships, or different product lines
• CRM platform: Salesforce, HubSpot, Zoho, or Pipedrive — and the specific pipeline/opportunity object if the platform supports multiple pipeline types
• Activity association (optional): Whether to log the update as a specific activity type — call, meeting, email, task, demo, or custom activity — with timestamp, duration, and participants
• Follow-up actions (optional): Tasks to create as a result of this update — schedule next call, send proposal, loop in technical resource, create SOW, or set reminder for follow-up date with assignee and due date
• Notification preferences (optional): Whether to notify the deal owner, account executive, or manager about this pipeline change — and via which channel (CRM notification, email, Slack)
• Batch update scope (optional): If updating multiple deals at once — a list of deal identifiers with the same update to apply, or a filter criteria to select deals (e.g., "all deals in Discovery stage with close date before March 1")
• Win/loss analysis fields (optional): If closing a deal — won/lost reason, competitor involved, deciding factor, lessons learned, and whether the contact should enter a win-back or referral sequence
• Revenue recognition details (optional): For closed-won deals — contract terms (monthly/annual), start date, renewal date, one-time vs. recurring revenue split, and any discount or promotional pricing applied
• Related deals (optional): Whether this update affects related deals — upsell opportunities, cross-sell deals, or renewal pipeline that should be created or updated based on this deal's stage change

Process

1. Load brand context: Read ~/.claude-marketing/brands/_active-brand.json for the active slug, then load ~/.claude-marketing/brands/{slug}/profile.json. Apply brand voice, compliance rules for target markets (skills/context-engine/compliance-rules.md), and industry context. Also check for guidelines at ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json — if present, load restrictions and relevant category files. Check for agency SOPs at ~/.claude-marketing/sops/. If no brand exists, ask: "Set up a brand first (/digital-marketing-pro:brand-setup)?" — or proceed with defaults.
2. Check connected CRM and pipeline configuration: Verify CRM connection status, retrieve available pipelines and their stage definitions (including required fields per stage, stage ordering, and probability defaults), and confirm the user has write access to the target pipeline. If multiple pipelines exist, present options for selection.