ドキュメント

スキルを入れて、キーを取って、最初の実験を回す。5分で終わります。

1 · API キーを作成

アカウントを作成 （または サインイン ——usecaseify.com のアカウントがそのまま使えます）。その後、 ダッシュボードでキーを作成し、コーディングエージェントを動かすシェルで設定してください：

export USECASEIFY_API_KEY=ucfy_gtm_...

gitignore 済みの .env に書いても構いません。コミットは厳禁です。

2 · インストール（Claude Code · Codex · Cursor）

プロダクトのリポジトリのルートで：

curl -fsSL https://gtm.usecaseify.com/install.sh | bash

コマンド一発で3エージェント対応：Claude Code には .claude/skills/ のスキル（スラッシュコマンド）、Codex / Cursor には AGENTS.md へのルーティングブロックと .agents/usecaseify-gtm/ の中立指示書——「次の GTM 実験を実行して」と言うだけで動きます。書き込むのはこれらのパスのみ。気になる場合は先に中身を読んでください。

3 · 実行する

  1. リポジトリでエージェントを開き、/gtm-next-experiment を実行。コードベースを調べ、3つの質問をして、GTM ブレインを呼び出します。エージェントに日本語で話しかければ（または指定すれば）、ブリーフと判定は日本語で生成されます。
  2. gtm/exp-001/BRIEF.md を確認。文言は編集できます——承認して開始すると、Continue / Iterate / Kill のルールがロックされます。
  3. エージェントに TASKS.md を実装させ、デプロイして、待ちます。
  4. リマインダーが鳴ったら /gtm-decision を実行。エージェントが実データを収集し、定性的な質問に2つ答えると、判定が DECISION.md に書き込まれます。

その他のエージェントをお使いの場合

このブートストラッププロンプトを貼り付けてください——同じ API フローで動きます：

You are working in my product's repository. I want to run one GTM experiment with UseCaseify GTM (https://gtm.usecaseify.com/docs).

1. Read the API reference at https://gtm.usecaseify.com/docs — the base URL is https://gtm.usecaseify.com and my key is in the USECASEIFY_API_KEY environment variable (Authorization: Bearer).
2. Inspect this repository (stack, analytics, signup flow, pricing, existing events). Summarize it as the repo_context object. NEVER include secrets, keys, or customer data.
3. Ask me: my biggest GTM problem right now, product stage, and current users/pricing. If I communicate in Japanese, set "output_language": "ja".
4. POST /api/v1/experiments/generate and poll the job. Write the returned brief_markdown to gtm/exp-<n>/BRIEF.md and tasks_markdown to gtm/exp-<n>/TASKS.md.
5. Walk me through the assumption and experiment. If I approve, POST .../start, save reminder_ics as gtm/exp-<n>/reminder.ics, commit the files, then implement TASKS.md exactly within its stated scope.
6. When I return with results, collect the values listed in TASKS.md "Results to report" from real data only, confirm them with me, POST .../results then .../decision, and write the decision_markdown to gtm/exp-<n>/DECISION.md.

API リファレンス

Base URL https://gtm.usecaseify.com · ヘッダー Authorization: Bearer ucfy_gtm_... · JSON in, JSON out.

POST/api/v1/lockRegister a locally-generated experiment: the server re-validates the guards, timestamps the lock (T0), and publishes the registry page. Free-tier locks are public.
POST/api/v1/reportClose an experiment with its honest outcome (results + verdict + final call), or as `abandoned`. Integrity flags computed server-side.
POST/api/v1/experiments/generateHosted generation (we pay the tokens, quota'd): one assumption + one experiment from project info and repo context. Accepts output_language: "en" | "ja". Returns a job to poll.
GET/api/v1/jobs/:idPoll a job. `succeeded` responses carry the full output (spec + markdown files).
POST/api/v1/experiments/:id/startMark as started: locks the decision criteria, returns the calendar reminder (.ics).
POST/api/v1/experiments/:id/resultsSubmit quantitative + qualitative results when the experiment ends.
POST/api/v1/experiments/:id/decisionRun the Continue / Iterate / Kill analysis on submitted results. Returns a job.
POST/api/v1/decisions/:id/finalizeRecord the human's final call (override requires a reason).
GET/api/v1/experiments/:idFetch an experiment's state, markdown artifacts, and decisions.
GET/api/v1/meVerify the key; see quota and active experiments.

生成と判定は非同期です：POST は 202 と job_id を返すので、/api/v1/jobs/:id を5秒ごとにポーリングし、succeeded または failed を待ちます。

制限とデータの扱い

  • 無料ベータ：アカウントごとに月3回まで、同時に実行できる実験は1つ。
  • 出力言語：生成時に output_language "ja" を渡すと、BRIEF.md・DECISION.md・生成される文言はすべて日本語になります。TASKS.md の骨組みは英語のまま（エージェント向け）。
  • 保存するのは送信されたものだけ：プロダクト説明、リポジトリの意味的サマリー、生成された実験、提出された結果。コードは見えません——エージェントが送るのはサマリーであり、ファイルではありません。
  • 秘密情報は絶対に送らないでください。認証情報の形をした文字列（API キー、接続文字列、秘密鍵）を含むペイロードは 400 secret_detected で即座に拒否されます。
  • リクエストボディの上限は 256KB です。
  • お問い合わせ・アカウント削除： [email protected]