Help / Red Codens

Red Codens セットアップ

エラー検知 → 自動修正 PR。Sentry や手動報告から検知したバグを解析し、修正 plan を生成。複雑な fix は Purple chain に提出して PR まで自動化します。

概要

Red Codens のメインユニットは bug report です。bug report は次のいずれかから生成されます：

Sentry webhook: Sentry の Internal Integration から受信して自動起票
手動報告 (UI / API / MCP): 人間や agent が直接 bug を切る
Blue / Purple からの自動連携: E2E 失敗や workflow fail を bug 化

解析が走ると fix plan が生成され、ワンクリック / 1 コールで Purple Codens に提出して PR を出すところまで自動化できます。3-Retry ロジックでテスト fail から最大数回まで自動改善します。

前提条件

Codens アカウントと organization が作成済み
codens-mcp がインストール済み・ログイン済み
対象 GitHub リポジトリへの admin / write 権限
Codens GitHub App をインストール済み（PR 作成のため必須）
Sentry 連携を使う場合は Sentry organization owner / manager 権限（webhook 作成のため）

Step 1. プロジェクト作成 + repo 紐付け

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

// 複数プロダクトに 1 コールで登録
await tools.codens_register_project_unified({
  repo_full_name: "Corevice/your-repo",
  products: ["red", "purple"]
});

project 作成時に GitHub App の install ステータスを確認するため、未 install の場合は install フローへ誘導されます。

Step 2. エラーソースの接続

Sentry を使う場合

Red ダッシュボード → Project → Integrations → Sentry → 「Connect」
表示される webhook URL と signing secret を Sentry の Internal Integration に登録
Sentry 側で対象 issue の alert rule から webhook を呼ぶよう設定

issue が webhook で届くと自動で bug report が作成され、解析がキックされます。

手動 / agent から起票する場合

// 解析もまとめてキック
await tools.red_bug_report({
  action: "create",
  project_id: "...",
  title: "Login endpoint returns 500 on empty password",
  description: "...",
  severity: "high",
  auto_analyze: true
});

Step 3. 最初の fix plan → PR

// 解析結果から fix plan を生成
const plan = await tools.red_bug_fix_plan({
  action: "generate",
  bug_id: "..."
});

// Purple Codens に提出して PR 化
const submission = await tools.red_bug_fix_plan({
  action: "submit_to_purple",
  plan_id: plan.id
});
// → workflow run が走り、PR URL が返る

単純な fix は red_fix_proposal 単独でも PR を出せますが、構造的な修正や複数ファイルにまたがる fix は Purple chain の方が結果が良くなります。

運用上のポイント

3-Retry ロジック: テストが落ちたら最大 3 回まで fix を改善。pass した時点で即終了
Slack 通知: 完了 / 失敗を Slack に通知（org の Slack workspace を link して有効化）
外部タスク: red_external_task で「リファクタリング」「機能追加」「テスト作成」など bug 以外のタスクも実行可能
Blue → Red chain: E2E 失敗から自動的に bug report 化し、Red の解析パイプに乗せられます

次のステップ