@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/campaign/SKILL.md

@@ -1,73 +0,0 @@
----
-name: ckm:campaign
-description: Marketing campaign planning, execution, optimization. Create campaigns, track status, analyze performance, manage budgets, coordinate multi-channel efforts.
-argument-hint: "[create|status|analyze|email] [name]"
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-# Campaign
-
-End-to-end campaign planning, execution, and optimization.
-
-<args>$ARGUMENTS</args>
-
-## When to Use
-
-- Campaign planning and launch execution
-- Multi-channel coordination
-- Budget allocation and timeline management
-- Performance tracking and optimization
-- Email campaign management
-
-## Campaign Types
-
-Product Launch, Seasonal/Promotional, Brand Awareness, Lead Generation, Re-engagement
-
-## Workflow
-
-1. **Parse Arguments** — extract action + campaign name from `$ARGUMENTS`
-2. **Route to Action:**
-   - `create`: Gather requirements → `campaign-manager` agent → `funnel-architect` agent → output to `assets/campaigns/`
-   - `status`: Read campaign files → `analytics-analyst` agent → display progress
-   - `analyze`: `analytics-analyst` + `campaign-debugger` agents → generate report
-   - `email`: Email campaign creation and management
-
-## Subcommands
-
-| Subcommand | Description | Reference |
-|------------|-------------|-----------|
-| `analyze` | Analyze campaign performance | `references/analyze.md` |
-| `create` | Create comprehensive digital marketing campaign | `references/create.md` |
-| `email` | Email campaign management | `references/email.md` |
-| `status` | Get campaign status | `references/status.md` |
-
-## References (Knowledge Base)
-
-| Topic | File |
-|-------|------|
-| Campaign Brief | `references/campaign-brief.md` |
-| Launch Checklist | `references/launch-checklist.md` |
-| Budget Allocation | `references/budget-allocation.md` |
-| Optimization Framework | `references/optimization-framework.md` |
-
-## Agents Used
-
-- `campaign-manager` — Campaign orchestration
-- `funnel-architect` — Funnel design
-- `analytics-analyst` — Performance tracking
-- `campaign-debugger` — Issue diagnosis
-
-## Output
-
-- Campaign briefs → `assets/campaigns/{date}-{slug}/briefs/`
-- Campaign creatives → `assets/campaigns/{date}-{slug}/creatives/`
-- Campaign reports → `assets/campaigns/{date}-{slug}/reports/`
-- Analysis reports → `assets/diagnostics/campaign-audits/{date}-{name}.md`
-
-## Routing
-
-1. Parse subcommand from `$ARGUMENTS` (first word)
-2. Load corresponding `references/{subcommand}.md`
-3. Execute with remaining arguments

package/.opencode/skills/campaign/references/analyze.md

@@ -1,50 +0,0 @@
-Analyze marketing campaign performance with insights and recommendations.
-
-<campaign_name>$ARGUMENTS</campaign_name>
-
-## Workflow
-
-1. **Gather Data**
-   - Read campaign configuration from `campaigns/{name}/`
-   - Use `analytics-analyst` agent for performance metrics
-   - If MCP available, fetch real-time analytics
-
-2. **Performance Analysis**
-   - Use `campaign-debugger` agent for issue identification
-   - Analyze conversion funnel
-   - Compare against benchmarks
-   - Identify top/bottom performers
-
-3. **Generate Insights**
-   - Use `funnel-architect` agent for optimization suggestions
-   - Calculate ROI and attribution
-   - Identify improvement opportunities
-
-4. **Create Report**
-   - Executive summary
-   - Detailed metrics breakdown
-   - Actionable recommendations
-   - Output to `reports/campaign-analysis-{date}-{name}.md`
-
-## Agents Used
-- `analytics-analyst` - Performance data
-- `campaign-debugger` - Issue diagnosis
-- `funnel-architect` - Optimization
-
-## Skills Used
-- `analytics` - Metrics frameworks
-- `campaign` - Analysis templates
-- `assets-organizing` - Standardized output paths
-
-## MCP Integrations
-- GA4 - Traffic and conversion data
-- Google Ads - Ad performance
-
-## Output
-- Analysis report → `assets/diagnostics/campaign-audits/{date}-{name}.md`
-
-## Examples
-```
-/campaign/analyze "Q1 Product Launch"
-/campaign/analyze "Black Friday Sale"
-```

package/.opencode/skills/campaign/references/budget-allocation.md

@@ -1,85 +0,0 @@
-# Budget Allocation Framework
-
-## Allocation Models
-
-### 70-20-10 Rule
-- **70%** Proven channels (best ROI)
-- **20%** Growth channels (scaling)
-- **10%** Experimental (testing new)
-
-### Objective-Based
-| Objective | Channel Focus |
-|-----------|---------------|
-| Awareness | Display, Video, Social |
-| Consideration | Search, Content, Retargeting |
-| Conversion | Search, Retargeting, Email |
-| Retention | Email, CRM, Loyalty |
-
-### Funnel-Based
-- **Top of Funnel:** 30-40%
-- **Middle of Funnel:** 30-40%
-- **Bottom of Funnel:** 20-30%
-
-## Channel Benchmarks
-
-| Channel | Typical % | When to Increase |
-|---------|-----------|------------------|
-| Paid Search | 25-35% | High-intent keywords available |
-| Paid Social | 20-30% | Good audience match |
-| Display | 10-15% | Awareness goals |
-| Email | 5-10% | Good list size |
-| Content | 10-20% | SEO opportunity |
-| Influencer | 5-15% | Authentic fit |
-
-## Budget Pacing
-
-### Daily Budget
-```
-Daily Budget = Total Budget / Campaign Days
-```
-
-### Pacing Strategies
-- **Even:** Same spend daily
-- **Frontloaded:** Higher early, optimize later
-- **Backloaded:** Start slow, increase proven
-- **Dayparted:** Vary by day/time
-
-### Pacing Check
-```
-Expected Spend = (Days Elapsed / Total Days) × Budget
-Variance = Actual Spend - Expected Spend
-```
-
-## Reallocation Triggers
-
-**Increase Budget When:**
-- ROAS > target by 20%+
-- CVR significantly above average
-- Plenty of impression share headroom
-
-**Decrease Budget When:**
-- ROAS < target for 3+ days
-- CVR declining trend
-- Quality score dropping
-
-**Move Budget When:**
-- One channel outperforming another
-- Audience saturation reached
-- New opportunity identified
-
-## Sample Budget Template
-
-```markdown
-## Campaign Budget: [Name]
-
-Total: $[X]
-
-| Channel | Budget | % | Daily |
-|---------|--------|---|-------|
-| Paid Search | $X | X% | $X |
-| Paid Social | $X | X% | $X |
-| Display | $X | X% | $X |
-| Email | $X | X% | $X |
-
-Reserve (contingency): $X (10%)
-```

package/.opencode/skills/campaign/references/campaign-brief.md

@@ -1,79 +0,0 @@
-# Campaign Brief Template
-
-## Campaign Overview
-
-```markdown
-# Campaign Brief: [Campaign Name]
-
-## Background
-[Context and reason for campaign]
-
-## Objective
-**Primary Goal:** [Specific, measurable objective]
-**Secondary Goals:** [Additional objectives]
-
-## Target Audience
-**Primary Segment:**
-- Demographics: [Age, location, etc.]
-- Psychographics: [Interests, behaviors]
-- Pain Points: [Problems we solve]
-
-**Secondary Segment:** [If applicable]
-
-## Key Messages
-**Primary Message:**
-[Main thing we want audience to remember]
-
-**Supporting Messages:**
-1. [Message 1]
-2. [Message 2]
-3. [Message 3]
-
-## Campaign Details
-
-### Timeline
-- Planning: [dates]
-- Asset Creation: [dates]
-- Launch: [date]
-- Duration: [length]
-- Post-mortem: [date]
-
-### Budget
-- Total: $[X]
-- Paid Media: $[X]
-- Creative: $[X]
-- Other: $[X]
-
-### Channel Mix
-| Channel | Allocation | Role |
-|---------|------------|------|
-| [Channel] | $[X] / [%] | [Purpose] |
-
-## Creative Requirements
-
-### Assets Needed
-| Asset | Specs | Owner | Due |
-|-------|-------|-------|-----|
-
-### Creative Direction
-[Tone, style, visual guidelines]
-
-## Success Metrics
-
-| KPI | Target | Measurement |
-|-----|--------|-------------|
-| [Metric] | [Value] | [How tracked] |
-
-## Approval
-- Brief Approved By: [Name] on [Date]
-- Creative Approved By: [Name] on [Date]
-- Final Sign-off: [Name] on [Date]
-```
-
-## Brief Best Practices
-
-1. Keep it focused (1-2 pages)
-2. Include clear success criteria
-3. Get stakeholder sign-off
-4. Share with all team members
-5. Reference throughout campaign

package/.opencode/skills/campaign/references/create.md

@@ -1,211 +0,0 @@
-Create effective digital marketing campaigns with strategy, execution plan, and creative direction.
-
-<brief>$ARGUMENTS</brief>
-
-## Your Mission
-
-Design a comprehensive, executable marketing campaign using discovery, ideation, strategy selection, and detailed execution planning.
-
-## Phase 1: Discovery
-
-Use `AskUserQuestion` to gather campaign essentials:
-
-**Question Set A (Campaign Foundation)**
-- Campaign objective: Brand awareness | Lead generation | Sales conversion | Product launch | Re-engagement
-- Target audience: Who are we reaching? (demographics, psychographics, pain points)
-- Budget range: $500-2K | $2K-10K | $10K-50K | $50K+
-- Timeline: 1-2 weeks | 1 month | 2-3 months | Ongoing
-
-**Question Set B (Context)**
-- Primary channels: Paid ads | Social organic | Email | Content | Influencer | Mix
-- Existing assets: Landing page | Email list | Social following | Content library
-- Success metrics: What defines campaign success?
-- Brand guidelines: Any constraints or requirements?
-
-Read `docs/brand-guidelines.md` for brand context. Activate `brand` skill.
-
-## Phase 2: Ideation & Options
-
-Use `brainstormer` skill to enter brainstorming session and generate 3-5 campaign concepts:
-
-For each concept provide:
-1. **Campaign theme** - Core creative idea
-2. **Hook angle** - Why audience will care
-3. **Channel strategy** - Platform priorities
-4. **Content pillars** - Key content types
-5. **Differentiation** - Why this approach wins
-
-Present options via `AskUserQuestion` for user selection.
-
-## Phase 3: Strategy Development
-
-Based on selected approach, use `campaign-manager` agent to create:
-
-### 3.1 Campaign Brief
-- Objective and KPIs
-- Target audience profile
-- Key messages (primary + supporting)
-- Channel mix and budget allocation
-- Timeline with milestones
-- Success criteria
-
-### 3.2 Funnel Architecture
-Use `funnel-architect` agent:
-- Design awareness → interest → consideration → decision flow
-- Map touchpoints per stage
-- Plan offer sequencing (Hormozi model)
-- Define conversion triggers
-
-### 3.3 Platform Strategy
-Activate `ads-management` skill for paid channels:
-
-| Platform | Role | Budget % | Objectives |
-|----------|------|----------|------------|
-| Google Ads | Intent capture | [%] | [objectives] |
-| Meta Ads | Discovery + retargeting | [%] | [objectives] |
-| LinkedIn | B2B targeting | [%] | [objectives] |
-| TikTok | Awareness | [%] | [objectives] |
-
-## Phase 4: Creative Direction
-
-Use `content-creator` agent with `creativity` skill:
-
-### 4.1 Content Plan
-- Blog posts / articles
-- Social media content calendar
-- Video scripts (if applicable)
-- Ad copy variations (5+ per platform)
-- Email sequences
-
-### 4.2 Ad Creative Briefs
-For each platform:
-- Ad format specs
-- Copy variations (headlines, descriptions, CTAs)
-- Visual direction
-- A/B test plan
-
-### 4.3 Landing Page Strategy
-- Hero section copy
-- Value proposition
-- Social proof placement
-- CTA structure
-
-## Phase 5: Execution Plan
-
-### 5.1 Pre-Launch Checklist
-Activate `campaign` skill → `references/launch-checklist.md`
-- Technical setup (pixels, tracking, UTMs)
-- Platform configuration
-- Asset approval workflow
-- Team responsibilities
-
-### 5.2 Launch Timeline
-| Week | Phase | Activities | Deliverables |
-|------|-------|------------|--------------|
-| W-2 | Prep | Asset creation, setup | Creatives, tracking |
-| W-1 | QA | Testing, approvals | Go/no-go decision |
-| W1 | Launch | Activation, monitoring | Live campaigns |
-| W2+ | Optimize | A/B testing, scaling | Performance reports |
-
-### 5.3 Budget Allocation
-Activate `campaign` skill → `references/budget-allocation.md`
-
-## Phase 6: Tracking & Measurement
-
-Use `analytics-analyst` agent. Activate `analytics` skill:
-
-### 6.1 KPI Framework
-| Metric | Target | Tracking Method |
-|--------|--------|-----------------|
-| Impressions | [X] | Platform analytics |
-| CTR | [X%] | Platform analytics |
-| CVR | [X%] | GA4 + pixel |
-| CPA | $[X] | Attribution model |
-| ROAS | [X]x | Revenue tracking |
-
-### 6.2 Attribution Setup
-- Define attribution model (first/last/linear/data-driven)
-- UTM parameter schema
-- Conversion event setup
-- Cross-platform tracking
-
-### 6.3 Reporting Cadence
-- Daily: Spend pacing, anomaly detection
-- Weekly: Performance summary, optimization actions
-- Monthly: Full analysis, budget reallocation
-- End: Post-mortem report
-
-## Phase 7: Integration & Automation
-
-### 7.1 MCP Integrations (if configured)
-- `google-ads` - Campaign automation
-- `google-analytics` - Performance data
-- `sendgrid` / `resend` - Email delivery
-- `slack` - Alerts and notifications
-
-### 7.2 Automation Workflows
-- Lead scoring triggers
-- Retargeting sequences
-- Email drip activation
-- Alert thresholds
-
-## Agents Used
-
-| Agent | Role |
-|-------|------|
-| `campaign-manager` | Campaign orchestration, brief creation |
-| `brainstormer` | Creative ideation, concept generation |
-| `funnel-architect` | Funnel design, conversion optimization |
-| `content-creator` | Content planning, copy creation |
-| `copywriter` | Ad copy, landing page copy |
-| `analytics-analyst` | Tracking setup, measurement |
-| `ads-specialist` | Platform-specific ad strategies |
-
-## Skills Activated
-
-- `campaign` - Brief templates, launch checklist
-- `ads-management` - Platform specs, ad copy templates
-- `analytics` - KPI frameworks, attribution models
-- `content-marketing` - Content strategy
-- `email` - Email sequences
-- `brand` - Brand context injection
-- `creativity` - Creative direction
-- `assets-organizing` - Standardized output paths
-
-## Output Structure
-
-```
-assets/campaigns/{date}-{campaign-slug}/
-├── briefs/
-│   ├── campaign-brief.md
-│   ├── creative-brief.md
-│   └── channel-briefs/
-├── creatives/
-│   ├── ads/{platform}/
-│   ├── social/
-│   └── email/
-├── copy/
-│   ├── landing-page.md
-│   ├── ad-copy.md
-│   └── email-sequences/
-├── tracking/
-│   ├── utm-schema.md
-│   └── conversion-events.md
-└── reports/
-    └── {date}-campaign-plan.md
-```
-
-## Token Efficiency
-
-- Use progressive disclosure: gather requirements first, then expand
-- Parallelize agent calls where independent
-- Reference skill templates instead of generating from scratch
-- Focus on actionable outputs over comprehensive documentation
-
-## Examples
-
-```bash
-/campaign:create "Q1 Product Launch"
-/campaign:create "Black Friday sale for SaaS product"
-/campaign:create "lead gen for enterprise B2B"
-```

package/.opencode/skills/campaign/references/email.md

@@ -1,59 +0,0 @@
-Email campaign management for drip sequences, newsletters, and automated emails.
-
-<args>$ARGUMENTS</args>
-
-## Actions
-- `create` - Create email campaign
-- `sequence` - Design drip sequence
-- `test` - A/B test design
-
-## Workflow
-
-1. **Parse Action** from `$ARGUMENTS`
-
-2. **Create Workflow**
-   - Use `email-wizard` agent to design email structure
-   - Gather email details via `AskUserQuestion`:
-     - Subject line variants
-     - Audience segment
-     - Send timing
-   - Use `copywriter` agent for email copy
-   - Activate `email` skill for templates
-   - Output to `campaigns/email/{campaign-name}/`
-
-3. **Sequence Workflow**
-   - Use `email-wizard` agent for drip architecture
-   - Design trigger conditions
-   - Create email sequence timeline
-   - Generate sequence files
-
-4. **Test Workflow**
-   - Use `email-wizard` agent for A/B test design
-   - Generate variant copies
-   - Define test parameters
-   - Output test plan
-
-## Agents Used
-- `email-wizard` - Email strategy and optimization
-- `campaign-manager` - Campaign coordination
-- `copywriter` - Email copywriting
-
-## Skills Used
-- `email` - Templates and best practices
-- `assets-organizing` - Standardized output paths
-
-## MCP Integrations
-- SendGrid - Email delivery
-- Resend - Transactional email
-
-## Output
-- Email copy → `assets/copy/emails/{date}-{sequence}-{slug}.md`
-- Sequences → `assets/campaigns/{date}-{slug}/briefs/email-sequence.md`
-- Test plans → `assets/funnels/tests/{date}-{test-name}.md`
-
-## Examples
-```
-/campaign/email create
-/campaign/email sequence
-/campaign/email test
-```

package/.opencode/skills/campaign/references/launch-checklist.md

@@ -1,70 +0,0 @@
-# Campaign Launch Checklist
-
-## Pre-Launch (1 Week Before)
-
-### Strategy
-- [ ] Campaign brief approved
-- [ ] Budget allocated and approved
-- [ ] Timeline confirmed
-- [ ] Roles and responsibilities assigned
-- [ ] Stakeholder communication plan set
-
-### Creative Assets
-- [ ] All ad creatives complete and approved
-- [ ] Landing pages live and tested
-- [ ] Email templates approved
-- [ ] Social posts scheduled
-- [ ] Copy variations ready for A/B testing
-
-### Technical Setup
-- [ ] Tracking pixels installed
-- [ ] UTM parameters defined
-- [ ] Conversion events configured
-- [ ] Attribution model set
-- [ ] Reporting dashboard ready
-
-### Platform Setup
-- [ ] Ad accounts funded
-- [ ] Campaigns built in platforms
-- [ ] Audiences created and verified
-- [ ] Bidding strategy selected
-- [ ] Daily budgets configured
-
-## Launch Day
-
-### Pre-Launch (Morning)
-- [ ] Final QA of all links
-- [ ] Test conversions tracking
-- [ ] Confirm all assets approved
-- [ ] Team notified of launch time
-- [ ] Monitoring plan in place
-
-### Launch
-- [ ] Campaigns activated
-- [ ] First impressions/clicks verified
-- [ ] No errors in platforms
-- [ ] Landing pages loading properly
-- [ ] Slack/email announcement sent
-
-### Post-Launch (Same Day)
-- [ ] Verify data flowing to analytics
-- [ ] Check early performance metrics
-- [ ] Address any immediate issues
-- [ ] Update stakeholders
-
-## Post-Launch (48-72 Hours)
-
-- [ ] Review initial performance
-- [ ] Pause underperformers
-- [ ] Scale winners if applicable
-- [ ] Document early learnings
-- [ ] Adjust bidding if needed
-- [ ] Plan first optimization round
-
-## Weekly During Campaign
-
-- [ ] Performance review
-- [ ] Budget pacing check
-- [ ] Optimization actions
-- [ ] Stakeholder update
-- [ ] Competitive monitoring