/digital-marketing-pro:sop-library

/digital-marketing-pro:sop-library

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

Manage the agency's Standard Operating Procedure library. Create SOPs from templates, assign them to specific brands, track compliance against recent executions, and maintain version control. SOPs define mandatory steps for common marketing operations — ensuring consistency, quality, and accountability across all client engagements regardless of which team member is executing the work.

Input Required

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

• Action: One of: create, list, assign, check-compliance, update, or view
• SOP category: The operational area — content-production, paid-media, reporting, crm, seo, social-media, email-marketing, client-management, onboarding, or general
• Brand slug (for assign/check-compliance): Which brand to assign the SOP to or check compliance against — must match a configured brand in ~/.claude-marketing/brands/
• SOP name (for create/update/view): A descriptive name for the procedure (e.g., "Blog Post Publishing Checklist", "Monthly Reporting Workflow", "Paid Search Campaign Launch Protocol")
• SOP content (for create/update): The procedure steps, checklists, responsible roles, approval requirements, and quality gates — or indicate "from template" to use the category default template
• Version notes (for update): What changed and why — recorded in the version history log for audit trail and team communication
• Priority level (for create): One of:
  • Critical: Must follow for every execution — compliance failures trigger alerts to management
  • Standard: Recommended for consistency across team members
  • Advisory: Best practice guidance, not mandatory — for reference and training
• Brand-specific overrides (for assign): Any steps that should be modified, skipped, or added for this specific brand's requirements, industry regulations, or client preferences
• Compliance date range (for check-compliance): How far back to look when checking executions against the SOP — defaults to last 30 days

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. 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 SOP storage: Read the SOP library at ~/.claude-marketing/sops/. Each SOP is stored as a JSON file with metadata (name, category, version, priority, created date, last updated, author, assigned brands, steps array, checklists, and version history)
3. For CREATE action: Generate a new SOP from the specified category template. Include:
   • Objective statement and scope definition
   • Prerequisites and required platform access
   • Numbered procedure steps with responsible roles and time estimates per step
   • Quality checkpoints at key gates with pass/fail criteria
   • Approval requirements with escalation paths
   • Completion criteria and rollback procedure if applicable
   • Save to ~/.claude-marketing/sops/{category}/{sop-slug}.json with version 1.0
4. For LIST action: Enumerate all SOPs in the library organized by category. Show name, version, priority level, last updated date, number of steps, total estimated duration, and assignment count (how many brands use this SOP). Highlight any unassigned SOPs and any with compliance rates below 80%
5. For ASSIGN action: Link the specified SOP to a brand by creating a reference at ~/.claude-marketing/brands/{slug}/sops/{sop-slug}.json containing the SOP reference, assignment date, assigner, and any brand-specific overrides or additions to the standard steps
6. For CHECK-COMPLIANCE action: Compare the brand's recent executions (from python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history) against the assigned SOP requirements. For each SOP step, determine pass/fail/not-applicable/skipped based on execution evidence. Calculate overall compliance percentage and identify patterns in recurring failures