solo-metrics-track

/metrics-track

プロジェクトのメトリクストラッキング計画を策定します。PostHog のイベントファネル、KPI ベンチマーク、リーンスタートアップの原則に基づく中止／反復／拡大の判断基準を定義します。

MCP ツール（利用可能な場合に使用）

• kb_search(query) — PostHog の手法や分析パターンを検索します

MCP ツールが利用できない場合は、Grep と Read を使用します。

手法の参考資料

このスキルでは、リーンスタートアップの原則に基づいてメトリクストラッキングを実施します。

• ニッチなベンチマークとの相対指標 — 見栄えだけの平均値ではなく、自社の推移と比較します
• 中止／反復／拡大の判断ルール — プロダクトに関する意思決定のための、データに基づく基準（下記のステップ 7 を参照）

手順

1. $ARGUMENTS からプロジェクトを解析します。

   • PRD を読み、機能、ICP、収益化モデルを確認します。
   • CLAUDE.md を読み、スタック（iOS／Web／両方）を確認します。
   • 空の場合：AskUserQuestion で質問します。

2. プラットフォームを検出します。

   • iOS アプリ → PostHog iOS SDK のイベント
   • Web アプリ → PostHog JS SDK のイベント
   • 両方 → クロスプラットフォーム ID（プラットフォーム間でユーザー ID を共有）

3. PostHog の手法を読み込みます。

   • MCP が利用可能な場合：kb_search("PostHog analytics events funnel identity")
   • それ以外の場合：既存の分析設定がプロジェクトのドキュメントにないか確認します
   • 抽出する内容：イベントの命名規則、ID 解決、ファネルのパターン

4. PRD の機能に基づいてイベントファネルを定義します。

   標準ファネル：Awareness → Acquisition → Activation → Revenue → Retention → Referral

   イベント表、KPI のしきい値、PostHog のコードスニペット、A/B テストのテンプレートについては、references/kpi-benchmarks.md を参照してください。イベントは対象のプロダクトに合わせて調整します。

5. 強制的な検討 — メトリクスの選定： KPI を定義する前に、次の項目を書き出します。

   • ノーススターメトリクス： 最も重要な指標を 1 つ選びます（例：「コアアクションを完了した週次アクティブユーザー数」）
   • 先行指標： ノーススターメトリクスを予測する指標は何ですか？（例：「D1 のアクティベーション率」）
   • 遅行指標： 成功を確認する指標は何ですか？（例：「MRR」「D30 の継続率」）
   • 避けるべき見栄えだけの指標：（例：アクティベーションを伴わない総ダウンロード数）

6. 各段階の KPI ベンチマークを設定します。

   references/kpi-benchmarks.md のしきい値を出発点として使用します。プロダクトの種類に合わせて調整します（B2B はボリュームが少なくコンバージョン率が高く、B2C モバイルはボリュームが多く継続率が低くなります）。

7. references/kpi-benchmarks.md の中止／反復／拡大フレームワークを使用して判断ルールを定義します。ステップ 6 で定めたプロジェクト固有の値に合わせて、しきい値を調整します。

8. references/kpi-benchmarks.md のプラットフォーム別の例を使用してPostHog の実装スニペットを生成します。イベント名とプロパティを、ステップ 4 で定義したファネルに合わせて調整します。

9. A/B テスト分析テンプレート — references/kpi-benchmarks.md からテンプレートをコピーし、メトリクス計画に含めます。判断ルール（SHIP／KEEP／EXTEND／INCONCLUSIVE）を含めます。

10. メトリクス計画を docs/metrics-plan.md に書き込みます。

# Metrics Plan: {Project Name}

**Generated:** {YYYY-MM-DD}
**Platform:** {iOS / Web / Both}
**North Star:** {north star metric}

## Event Funnel

| Stage | Event | Properties |
|-------|-------|------------|
{event table from step 4}

## KPIs & Thresholds

| KPI | Target | Kill | Scale |
|-----|--------|------|-------|
{benchmark table from step 6}

## Decision Rules

{framework from step 7}

## Implementation

### PostHog Setup
- Project: {project name} (EU region)
- SDK: {posthog-ios / posthog-js}
- Identity: {anonymous → identified on signup}

### Code Snippets
{snippets from step 8}

## A/B Test Template
{template from step 9}

## Dashboard Template
- Funnel: {stage1} → {stage2} → ... → {stageN}
- Retention: D1 / D7 / D30 cohort chart
- Revenue: MRR trend + trial conversion

---
*Generated by /metrics-track. Implement events, then review weekly.*

11. 概要を出力します — ノーススターメトリクス、主な基準、最初に実装するイベント、A/B テストテンプレートの有無を示します。

注意事項

• プライバシーコンプライアンスのため、PostHog の EU ホスティングを使用します
• ユーザープロパティには $set、イベントには capture を使用します
• ID：匿名で開始し、サインアップ時にユーザー ID を指定して identify() を実行します
• クロスプラットフォーム：同じ PostHog プロジェクトで同じユーザー ID を使用し、ユーザーの行動を統合します
• ダッシュボードを毎週確認し、中止／反復／拡大の判断を毎月行います

よくある問題

プラットフォームの検出結果が間違っている

原因： プロジェクトに Web と iOS の両方を示す情報があります。 解決方法： このスキルはパッケージマニフェストを確認します。両方が存在する場合は、クロスプラットフォームの ID 設定を生成します。出力で検出されたプラットフォームを確認してください。

KPI のしきい値が厳しすぎる

原因： デフォルトのしきい値は業界平均です。 解決方法： ニッチに合わせて docs/metrics-plan.md のしきい値を調整します。B2B は通常、ボリュームが少ない一方でコンバージョン率が高くなります。

PostHog SDK がプロジェクトにない

原因： メトリクス計画は生成されましたが、SDK がインストールされていません。 解決方法： このスキルが生成するのは計画のみです。PostHog SDK は別途インストールしてください。Web の場合は pnpm add posthog-js、iOS の場合は SPM で posthog-ios を追加します。