product-metrics

product-metrics — メトリクスブリーフ

以前のパイプラインが認識しながら埋められなかったギャップです。product-strategy は「メトリクスがなければ、問題は明確ではない」と求めていますが、そのメトリクスの構築を支援するツールはありませんでした。存在しないメトリクスコーチに引き継いでいたのです。このステーションでは、候補となるノーススターメトリクスを定義し、それを支えるレバーのツリーを構築し、すべての有効な仮説に数値、測定方法、そして今日時点の値を設定します。

呼び出されるタイミング

タイミング	呼び出し元／引き継ぎ先
product-strategy のメトリクスゲートを通過しない場合（「メトリクスがなければ、問題は明確ではない」）	product-strategy から開始（.agents/skills/product-strategy/SKILL.md）
メトリクスブリーフが作成された場合	prd に引き継ぎ（.agents/skills/prd/SKILL.md）—ノードの戦略的な context/ に、定義済みのメトリクスが設定されます
事前のゲートがない場合	読み込み済みのプロダクトノードに対して、単独で呼び出せます

隣接する2つのステーションは、どちらもこのパックにすでにインストールされています。ここでの言及は実在するものであり、作り話ではありません。仕様も担当者もないメトリクスコーチを以前参照していたのとは異なります。

インタビュー

.agents/skills/grill/SKILL.md#method に記載されたプレッシャー方式で実施します。パスで参照し、内容をコピーしません。 5つの要素（例を添えた問い返し、1〜2回に制限したプレッシャー、回答を避ける手段、エビデンスの優先順位、すべてのギャップの記録）は、そこに記載されたとおりに適用します。

質問する前に、読み込み済みのプロダクトノードに product-strategy による日付入りのリサーチ（仮説を含むディスカバリーブリーフ）がある場合は、それを読みます。有効な仮説はそこから取得するため、再度質問しません。事前のリサーチがない場合は、仮説を直接質問します。

次の4つのステップを、この順番で進めます。

1. 候補となるノーススターメトリクス

候補となるノーススターメトリクスを1つ定め、理由を1行で示します。つまり、「なぜ重要か」ではなく、どのプロダクト上の意思決定を動かすのかを示します。「成功を測るから」「みんなが見るものだから」など、意思決定を挙げない回答には、grill が問い返します。

2. メトリクスツリー

最上位にノーススターを置き、その下にレバーを配置します。レバーとは、動けばノーススターも動く変数です。各レバーについて、どこで測定するか（どのイベント、どのテーブル、どのソースか）を記載します。これは測定する場所であり、計測方法ではありません。計測方法はユーザーのプロダクト本体に属し、このツールの対象ではありません。測定する場所の記載がないレバーは、完全な項目ではなくギャップです。

3. 有効な仮説ごとのメトリクス

各有効な仮説（product-strategy から引き継いだもの、または事前のリサーチがない場合にここで挙げたもの）について、どの数値で仮説を検証または反証するのか、どう測定するのか、今日時点での値はいくらかを定めます。

厳守事項：出典のない値は、データではありません。 担当者が出典（ダッシュボード、測定値、日付入りの数値）を示せない今日時点の値を、示せるかのように記載してはいけません。grill と同じ形式で、誰が解消するのかを添えてギャップとして記録します。項目を完全に見せるために数値を捏造するのは、不完全な調査を完全なものとして提示することであり、システムのほかの部分で禁止されている行為と同じです。

4. アンチメトリクス

ノーススターの改善中に悪化させてはならないものと、アラームを発動するしきい値を定めます。しきい値には数値または検証可能な条件を使い、「大幅に悪化したら」のような表現は使いません。

虚栄のメトリクス

提案された各メトリクス（ノーススター、レバー、仮説のメトリクス）の後に、次の問いを必ず適用します。 この数値は、どちらの方向に動いても、どの意思決定を変えますか？

答えがない場合、または「成長の捉え方が変わる」のように別のメトリクスを答えている場合、それは虚栄のメトリクスです。「これは虚栄のメトリクスです。どの意思決定も変えません」と明言し、そのメトリクスをブリーフに採用する前に、具体的にどの意思決定を動かすべきかを尋ねます。黙って除外することも、インタビューを中断しないために受け入れることもありません。

Metric Brief

最後に、成果物を読み込まれたプロダクトノードの、日付付きのリサーチとして次の場所に書き込みます。

research/<YYYY-MM-DD>-metric-brief.md

日付付きで、上書きはしません。これは、このリポジトリのリサーチフォルダーですでに採用されている基準と同じです。パスは、brain 自身の tree.md にある content: */products/*/research/*.md の行に収まるため、新しい glob も resolver の行も必要ありません。プロダクトノードがない場合は、同じファイル <YYYY-MM-DD>-metric-brief.md が代わりに現在のフォルダーに配置されます。

Brief には、次の4つのセクションをこの順序で、それぞれ文字どおりの見出しとともに記載します。

## Candidate North Star
## Metric tree
## Metric per hypothesis
## Antimetrics

• 候補となる North Star：指標と、その理由を1行で記載します（どの意思決定に影響するか）。
• 指標ツリー：最上位に North Star を置き、各レバーを測定場所とともに1行ずつ記載します。
• 仮説ごとの指標：有効な仮説ごとに1項目を記載します。どの数値を、どのように測定し、今日時点の値、または担当者付きの不足分を示します。
• アンチメトリクス：それぞれに警告しきい値を付けます。

インタビュー中に虚栄指標が見つかった場合も、Brief にはそのまま記載し、ラベル「（虚栄指標：求められた意思決定に影響せず、未解決のまま担当者も決まらなかった場合はその旨を示す）」を付けます。黙って削除することはありません。

この成果物が主張しないこと

Metric Brief は、プロダクトノードに新たな正規ファイルを作成するものでも、作成を求めるものでもありません。日付付きのリサーチとして既存の内容に追加され、context/ 内の稼働中ファイルを置き換えたり、再バージョン管理を強制したりすることはありません。指標の正規ファイル（上書きされる稼働中の metrics.md）が必要になった場合、その判断を承認するのはオペレーターであり、このツールではありません。

保存先

このスキルは、成果物を作成する前に保存先を解決します。作成後に決めることはありません。ケースは3つ、保存先は2つです。

• プロダクトノードが読み込まれている場合：成果物はそのノードの research/<YYYY-MM-DD>-<name>.md に保存されます。
• brain はあるものの、プロダクトノードがない場合（まだワークスペースがない、またはワークスペースにノードがない場合）：成果物は現在のフォルダー内のファイルに書き込まれます。
• brain がまったくない場合：成果物は現在のフォルダー内のファイルに書き込まれます。

プロダクトノードがない場合も、ファイルは現在のフォルダーに書き込まれます。終了メッセージでは、書き込んだパスだけを示して終了します。これはこのスキルの通常の終了方法であり、例外として説明する必要はありません。

このスキルは保存先を尋ねることも、3つ目の保存先を勝手に作ることもありません。

残りのパックは、スキルを1つずつインストールします。まず .agents/skills/、次に .claude/skills/ を確認してください（両方にあるスキルは1つとして数えます）。そこにないものだけを、セッションごとに1回だけ提示してください。このスキルがセッション中に初めて終了したときに提示し、同じ成果物または別の成果物で後から終了しても、再び提示することはありません。

• grill — npx skills add pedroromeroluna/ai-first-product-skills --skill grill
• prd — npx skills add pedroromeroluna/ai-first-product-skills --skill prd
• product-strategy — npx skills add pedroromeroluna/ai-first-product-skills --skill product-strategy

パック全体を一度にインストールするには、npx skills add pedroromeroluna/ai-first-product-skills を実行します。このコマンドはパックで提供されるスキルをインストールします。上記に記載されたスキルは、それぞれ名前を指定してインストールします。