@hienlh/ppm 0.9.80 → 0.9.81

package/.opencode/workflows/analytics-workflow.md

@@ -0,0 +1,264 @@
+# Analytics Workflow
+
+Performance measurement and reporting process.
+
+## Overview
+
+| Field | Value |
+|-------|-------|
+| **Purpose** | Measure, analyze, report marketing performance |
+| **Agents** | analytics-analyst, campaign-debugger |
+| **Human Checkpoints** | Strategic recommendations |
+
+---
+
+## Workflow Stages
+
+### Stage 1: Data Collection
+
+**Agent:** `analytics-analyst`
+
+**Actions:**
+1. GA4 data queries
+2. Search Console metrics
+3. Platform-specific data
+4. CRM data export
+5. Ad platform metrics
+
+**Data Sources:**
+- Google Analytics 4
+- Google Search Console
+- Social platform insights
+- Email platform metrics
+- Ad platforms (Google, Meta, etc.)
+
+**Prompt Template:**
+```
+Collect analytics data for [period].
+Sources: [GA4, GSC, social, email, ads]
+Metrics: traffic, conversions, engagement, spend
+Export to: plans/reports/data/[date]-raw-data.json
+```
+
+---
+
+### Stage 2: Analysis
+
+**Agent:** `analytics-analyst`
+
+**Actions:**
+1. Trend identification
+2. Attribution modeling
+3. Funnel analysis
+4. Segment comparison
+5. Anomaly detection
+
+**Output:** Analysis findings
+
+**Prompt Template:**
+```
+Analyze marketing data for [period].
+Focus areas:
+- Traffic trends by source
+- Conversion funnel performance
+- Top/bottom performing content
+- Attribution by channel
+Identify anomalies and opportunities.
+```
+
+---
+
+### Stage 3: Reporting
+
+**Agent:** `analytics-analyst`
+
+**Actions:**
+1. Dashboard updates
+2. Scheduled reports
+3. Executive summaries
+4. Team-specific views
+
+**Output:** Reports in `plans/reports/`
+
+**Report Types:**
+- Weekly performance summary
+- Monthly marketing report
+- Campaign-specific reports
+- Channel deep-dives
+
+**Prompt Template:**
+```
+Generate [report-type] for [period].
+Audience: [executive/marketing/sales]
+Include:
+- Key metrics overview
+- Trends and comparisons
+- Top performers
+- Areas of concern
+- Visualizations (describe for implementation)
+Save to: plans/reports/[date]-[report-type].md
+```
+
+---
+
+### Stage 4: Insights & Actions
+
+**Agent:** `analytics-analyst`
+
+**Human Checkpoint:** Strategic recommendations
+
+**Actions:**
+1. Extract actionable insights
+2. Prioritize recommendations
+3. Define next steps
+4. Set optimization targets
+
+**Output:** Action items with priorities
+
+**Prompt Template:**
+```
+Generate insights from [report-path].
+Provide:
+- Top 3 insights (data-backed)
+- Recommended actions (prioritized)
+- Expected impact
+- Resources needed
+Format as actionable tasks.
+```
+
+---
+
+## Report Templates
+
+### Weekly Performance Report
+```markdown
+# Weekly Performance: [Week]
+
+## Key Metrics
+| Metric | This Week | Last Week | Change |
+|--------|-----------|-----------|--------|
+| Sessions | X | Y | +/-% |
+| Conversions | X | Y | +/-% |
+| Revenue | $X | $Y | +/-% |
+
+## Highlights
+- [Top 3 wins]
+
+## Concerns
+- [Areas needing attention]
+
+## Next Week Focus
+- [Priorities]
+```
+
+### Monthly Marketing Report
+```markdown
+# Monthly Marketing Report: [Month]
+
+## Executive Summary
+[2-3 sentence overview]
+
+## Channel Performance
+### Organic
+### Paid
+### Email
+### Social
+
+## Campaign Performance
+[Active campaigns]
+
+## Funnel Analysis
+[Stage-by-stage conversion]
+
+## Recommendations
+[Prioritized action items]
+```
+
+---
+
+## Metrics Framework
+
+### Acquisition
+- Sessions, Users, New Users
+- Traffic by source/medium
+- Bounce rate, Pages/session
+
+### Engagement
+- Time on site
+- Scroll depth
+- Event completions
+- Content engagement
+
+### Conversion
+- Goal completions
+- Conversion rate
+- Revenue, AOV
+- Lead quality
+
+### Retention
+- Return visitors
+- Email engagement
+- Customer LTV
+- Churn rate
+
+---
+
+## Attribution Models
+
+### First Touch
+Credit to first interaction
+
+### Last Touch
+Credit to final interaction
+
+### Linear
+Equal credit across touchpoints
+
+### Time Decay
+More credit to recent touches
+
+### Position-Based
+40% first, 40% last, 20% middle
+
+---
+
+## Integration Points
+
+### Hooks Triggered
+- `campaign-tracking` → Data logged for analysis
+
+### Data Flow
+```
+[Collection] → [Analysis] → [Reporting] → [Actions]
+      ↑                                        │
+      └────────── Iteration Loop ──────────────┘
+```
+
+### Tools/APIs
+- GA4 API / BigQuery
+- Google Search Console API
+- Social platform APIs
+- Email platform APIs
+
+---
+
+## Usage Example
+
+```
+/analyze:report "monthly"
+
+# Triggers workflow:
+1. analytics-analyst: Collect data from all sources
+2. analytics-analyst: Analyze trends, funnels, attribution
+3. analytics-analyst: Generate monthly report
+4. analytics-analyst: Extract insights, recommend actions
+```
+
+---
+
+## Success Metrics
+
+- Report accuracy (data validation)
+- Insight quality (actionability)
+- Decision support (recommendations used)
+- Time to insight (collection → action)

package/.opencode/workflows/campaign-workflow.md

@@ -0,0 +1,228 @@
+# Campaign Workflow
+
+Single campaign lifecycle management from brief to post-mortem.
+
+## Overview
+
+| Field | Value |
+|-------|-------|
+| **Purpose** | Manage individual campaign lifecycle |
+| **Agents** | campaign-manager, content-creator, funnel-architect, analytics-analyst |
+| **Human Checkpoints** | Brief approval, Launch approval |
+
+---
+
+## Workflow Stages
+
+### Stage 1: Campaign Brief
+
+**Agent:** `campaign-manager`
+
+**Actions:**
+1. Define objectives (awareness, leads, sales)
+2. Set target audience
+3. Determine budget
+4. Establish KPIs
+5. Create timeline
+
+**Output:** Campaign brief in `plans/campaigns/`
+
+**Human Checkpoint:** Brief approval required
+
+**Prompt Template:**
+```
+Create campaign brief for [campaign-name].
+Objective: [objective]
+Budget: [budget]
+Timeline: [start] to [end]
+Include: audience, channels, KPIs, success criteria
+```
+
+---
+
+### Stage 2: Creative Development
+
+**Agent:** `content-creator`, `copywriter`
+
+**Actions:**
+1. Ad copy variations
+2. Visual concepts
+3. Landing page content
+4. Email templates
+
+**Output:** Creative assets in `content/campaigns/[campaign-id]/`
+
+**Prompt Template:**
+```
+Create creative assets for campaign [campaign-id].
+Channels: [channels]
+Messaging: [key-messages]
+Include: headlines, descriptions, CTAs, visual direction
+```
+
+---
+
+### Stage 3: Funnel Setup
+
+**Agent:** `funnel-architect`
+
+**Actions:**
+1. Design conversion path
+2. Setup tracking (UTMs, pixels)
+3. Configure attribution
+4. Create A/B test variants
+
+**Output:** Funnel configuration doc
+
+**Prompt Template:**
+```
+Design conversion funnel for [campaign-id].
+Entry points: [traffic sources]
+Goal: [conversion action]
+Include: funnel stages, tracking setup, test variants
+```
+
+---
+
+### Stage 4: Launch
+
+**Agent:** `campaign-manager`
+
+**Actions:**
+1. Final checklist verification
+2. Publish content
+3. Activate ad campaigns
+4. Start email sequences
+5. Enable tracking
+
+**Human Checkpoint:** Launch approval required
+
+**Requires:** `approval-workflow` hook
+
+**Prompt Template:**
+```
+Launch campaign [campaign-id].
+Verify: tracking, creatives, targeting, budget.
+Channels: [channels]
+Start date: [date]
+```
+
+---
+
+### Stage 5: Optimization
+
+**Agent:** `campaign-debugger`, `analytics-analyst`
+
+**Actions:**
+1. Monitor performance daily
+2. Analyze A/B test results
+3. Adjust targeting
+4. Optimize budget allocation
+5. Pause underperformers
+
+**Output:** Optimization reports
+
+**Prompt Template:**
+```
+Optimize campaign [campaign-id].
+Current metrics: [metrics]
+Issues: [issues]
+Recommend: targeting, budget, creative changes
+```
+
+---
+
+### Stage 6: Post-Mortem
+
+**Agent:** `analytics-analyst`
+
+**Actions:**
+1. Final performance analysis
+2. ROI calculation
+3. Learnings capture
+4. Recommendations
+
+**Output:** Campaign report in `plans/reports/`
+
+**Prompt Template:**
+```
+Generate post-mortem for campaign [campaign-id].
+Include: performance vs KPIs, ROI, key learnings.
+Recommend: improvements for next campaign
+```
+
+---
+
+## Agent Orchestration
+
+```
+[Brief] → [Creative] → [Funnel] → [Launch] → [Optimize] → [Post-Mortem]
+    │          │           │          │           │             │
+campaign-   content-    funnel-   campaign-  campaign-    analytics-
+manager     creator    architect   manager    debugger      analyst
+```
+
+---
+
+## Campaign Types
+
+### Product Launch
+- Focus: Awareness → Trial → Conversion
+- Duration: 4-8 weeks
+- Channels: All
+
+### Lead Generation
+- Focus: Capture → Nurture → Qualify
+- Duration: Ongoing
+- Channels: Content, Paid, Email
+
+### Promotional
+- Focus: Limited-time offer conversion
+- Duration: 1-2 weeks
+- Channels: Email, Paid, Social
+
+### Brand Awareness
+- Focus: Reach, Impressions, Engagement
+- Duration: 2-4 weeks
+- Channels: Social, Display, Content
+
+---
+
+## Integration Points
+
+### Hooks Triggered
+- `campaign-tracking` → All stage transitions
+- `approval-workflow` → Before launch
+- `brand-guidelines-reminder` → During creative
+
+### Data Flow
+- Brief → guides all subsequent stages
+- Creative → feeds Launch
+- Tracking → feeds Optimization
+- Post-mortem → feeds next campaign
+
+---
+
+## Usage Example
+
+```
+/campaign create "Black Friday 2024"
+
+# Triggers workflow:
+1. campaign-manager: Brief creation (await approval)
+2. content-creator: Promo creatives
+3. funnel-architect: Landing page → Checkout funnel
+4. campaign-manager: Launch checklist (await approval)
+5. campaign-debugger: Daily optimization
+6. analytics-analyst: Post-mortem report
+```
+
+---
+
+## Success Metrics
+
+- Reach (impressions, unique users)
+- Engagement (clicks, interactions)
+- Conversion (leads, sales)
+- ROI (revenue / spend)
+- Learnings (documented insights)