Help / Blue Codens

Blue Codens セットアップ

QA 自動化。自然言語の要件から Playwright E2E テストを自動生成し、Blue 側で実行 → 結果（video / trace / network log）を取得。失敗時は Red Codens にチェインして自動修正できます。

概要

Blue Codens の基本単位は E2E test です。自然言語要件から生成し、Blue 側のサンドボックスブラウザで実行されます。

テスト生成: Claude API + Playwright 用 codegen で安定したセレクタを優先
実行: Blue 側の Playwright runner で並列実行（同時実行数は plan tier 依存）
結果: pass / fail, video, trace, network log, console log を取得可能
失敗時連携: bug report として Red に流せる（Red → Purple chain で修正 PR）

前提条件

Codens アカウントと organization が作成済み
codens-mcp がインストール済み・ログイン済み
テスト対象 URL に Blue からアクセス可能（IP 制限がある場合は許可リスト追加が必要）
必要に応じてテスト用アカウントの credentials（保存先は Blue の暗号化 secret store）

Step 1. プロジェクト作成

ダッシュボード（app.blue.codens.ai）から「New Project」を選択するか、MCP 経由で他プロダクトとまとめて登録：

await tools.codens_register_project_unified({
  repo_full_name: "Corevice/your-repo",
  products: ["blue"]
});

project 内では複数の base URL（prod / staging / dev）を切り替えてテストを実行できます。

Step 2. テスト対象環境を登録

ダッシュボード → Project → Environments → 「Add environment」
Base URL（例: https://staging.your-app.example.com）を登録
必要であれば test user の credentials を secret として保存（テスト実行時に環境変数として注入）
IP 許可リストが必要な場合は表示される Blue 側 outbound IP を許可

本番環境への破壊的テストは要注意。「sign up を試す」のような mutating テストは staging や X-E2E-Run-ID ヘッダ付き専用環境で実行することを推奨します（実装規約は internal e2e integration spec を参照）。

Step 3. 最初の E2E テストを作る

// 自然言語要件から生成
const t = await tools.blue_e2e_test({
  action: "generate",
  project_id: "...",
  requirement: "Verify that a user can complete a checkout flow with an annual plan.",
  language: "playwright"
});

// 実行
await tools.blue_e2e_test({ action: "run", e2e_test_id: t.id });

// 結果取得（pass/fail, video URL, trace URL, network log）
const result = await tools.blue_e2e_test({
  action: "get_results",
  e2e_test_id: t.id
});

生成された Playwright スクリプトはダッシュボードから編集可能。次回以降は action: "run" だけで実行できます。

運用上のポイント

Red chain: 失敗テストを bug report 化 → Red の解析・修正 PR ループへ送る
Run ID 注入: テストランの識別のため X-E2E-Run-ID ヘッダが自動付与される（mutating テストの区別に利用）
Webhook (Blue → Purple): 大きな workflow の中で E2E を verify ステップとして使う場合は Purple workflow から E2E を呼ぶことも可能
Trace / Video の保管期間: plan tier に応じて保持期間が異なる（Pro 以上で長期保管）

次のステップ