posthog

# Kodo PostHog Analytics Skill

Ultimate product analytics assistant for PostHog implementation, event tracking, feature flags, experiments, and analytics documentation.

## Commands

All commands support inline context: `/kodo ph-event {event description}` or `/kodo ph-flag {feature context}`

| Command | Purpose |
|---------|---------|
| `/kodo ph-event [context]` | Plan and implement event tracking (autocapture + custom events) |
| `/kodo ph-flag [feature]` | Create, manage, and document feature flags |
| `/kodo ph-experiment [hypothesis]` | Design and implement A/B tests/experiments |
| `/kodo ph-sync [direction]` | Sync analytics documentation with Notion (push/pull/both) |
| `/kodo ph-dashboard [focus]` | Create and manage PostHog dashboards and insights |

## Workflow Overview

1. **Trigger detection** -> Identify analytics/tracking need
2. **Check config** -> Load `.kodo/config.json` for PostHog settings
3. **Discovery** -> Ask targeted questions about tracking requirements
4. **Implementation** -> Generate SDK code for frontend/backend
5. **Documentation** -> Create/update Notion docs with event catalog
6. **Validation** -> Verify instrumentation via PostHog MCP tools

## Project Configuration

Expects PostHog configuration in `.kodo/config.json`:

```json
{
  "stack": {
    "workspaces": {
      "server": {
        "analytics": {
          "provider": "posthog",
          "packages": {
            "server": "posthog-node",
            "client": "posthog-js"
          }
        }
      }
    }
  },
  "features": {
    "analytics": {
      "enabled": true,
      "provider": "posthog"
    }
  },
  "notion": {
    "teamspace": "MyTeamspace",
    "idPrefix": "KODO",
    "_populated_by_init": {
      "databases": {
        "events": { "dataSourceId": "collection://..." },
        "eventProperties": { "dataSourceId": "collection://..." },
        "featureFlags": { "dataSourceId": "collection://..." },
        "experiments": { "dataSourceId": "collection://..." },