このステージでは、ディスカバリ文書のルールを設定に変換します。以下のエリアを順番に処理してください。各エリアについては顧客と相談して決定し、設定を適用します。
作業中に各決定内容とその理由を記録してください。引き継ぎメモこれらのメモを元に構築されます。
プロジェクト
顧客と相談して決定:
- どのリポジトリをプロジェクトにするか。リポジトリごとに1つのプロジェクトを使用します。
- CoRoidがプルリクエストを作成する対象のブランチです。
- CoRoidがリポジトリにプッシュできるかどうか(同期済み)または読み取り専用(ローカルのみ)。
- コードのインストール、ビルド、テストを行うコマンドと、テストで必要なサービスです。
- エージェントが把握しておくべき、コードには明示されていない情報です。
各プロジェクトを「作成」から開始します。プロジェクトその後、プロジェクトの設定を開きます:リポジトリでブランチやモードを設定し、環境変数、およびナレッジ → コンテキストでエージェントが参照する内容を設定します。CoRoidが検出したビルド・テストコマンドを確認し、「ナレッジ → コンテキスト」にエージェントが把握すべき情報を記載してください。AGENTS.md、リポジトリ内に記載します。
「最初のプロジェクトを作成する」をご覧ください。最初のプロジェクトを作成する、リポジトリとブランチの設定、ビルド・テストの設定、およびAGENTS.mdを記述してください。。
品質管理
顧客と相談して決定:
- 各変更が満たすべき要件と、どの失敗がブロック要因となるか、あるいは警告のみかを決定します。
- QAの厳密さと、チェックが実行される場所を決定します。
- ユーザーが開くプルリクエストの処理方法:CoRoidによる品質管理と、CoRoidによるレビューを助言用またはブロック用とするかを決定します。
- Slack、Telegram、Jiraなど、リクエストを送信できるソースを決定します。
- タスクやデプロイの失敗などの障害が発生した際の対応を決定します。
「設定」で指定してください。品質管理「組織既定」を設定してください。組織既定ほとんどのプロジェクトで必要なチェックを「組織既定」に設定します。異なる設定が必要なプロジェクトのみ個別に設定してください。「品質ポリシーとゲート」をご覧ください。品質ポリシーとゲート、およびアンチスロップチェック。
CoRoidによるpull requestは、人がマージ操作を実行した場合のみマージされます。決済関連コードなど、特定の承認者が必要なコードには、Gitホスト上でブランチ保護を適用してください。
マンデート
マンデートを設定すると、エラートラッカーなどから人が介在しない状態で届いた作業をCoRoidが開始できます。ただし、マージやデプロイは許可されません。
顧客と相談して決定:
- CoRoidが自動的に開始できる作業と、対象のプロジェクトを決定します。
- 週または月あたりの利用上限額を決定します。
- 顧客が再度マンデートを確認するタイミングを決定します。
「マンデート」で設定してください。品質管理:「組織既定」を選択し、組織既定、その後マンデートを「デリバリー」グループ内で設定します。人が介在しない作業を希望しない場合は、マンデートを設定しないでください。「マンデート」をご覧ください。デリバリー人が介在しない作業を希望しない場合は、マンデートを設定しないでください。「マンデート」をご覧ください。マンデート。
AIプロファイル
顧客と相談して決定:
- 組織で既定として使用するプロファイルを決定します。
- モデル呼び出しをEU内に留めるかどうか。その場合は「EU限定」を使用します。EU限定。
- モデルの料金をCoRoidのモデルクレジットで支払うか、顧客自身のプロバイダーキーを使用するかを決定します。
- エージェントが使用を許可されないプロバイダーとモデルを決定します。
「プロファイル」で設定してください。設定 → AIプロファイル、キーは設定 → プロバイダーキー。プロバイダーとモデルを制限するには設定 → IDおよびアクセス → 組織ポリシー。詳細はAIプロファイル、プロバイダーキー、およびモデルクレジット。
オートメーション
顧客と相談して決定:
- スケジュールに基づいて開始される作業と、何かが発生した際に開始される作業を決定します。
- 各オートメーションの機能と対象のプロジェクトを決定します。
- オートメーションが読み取り・報告のみか、タスクを作成するかも決定します。
「オートメーション」で作成してください。新規作業、すべてのオートメーションは「ファクトリー → オートメーション」で確認できます。ファクトリー → オートメーション「品質管理」の下にあるスイッチにより、何かが壊れた際に各実行で1つのオートメーションが起動します。詳細は「オートメーション」をご覧ください。オートメーション、スケジュール、およびフック。
ワークフロー
ワークフローとは、サポート受信箱などのビジネスプロセスを指します。エージェントがその手順を実行し、指定された箇所で人が判断します。ワークフローはまだすべての組織で有効化されているわけではありません。CoRoid に依頼するそれを有効にしてもらう。
顧客と相談して決める:
- まず対応するプロセスを選びます。類似ケースが多く、明確なルールがあるものを選んでください。
- ケースの開始方法:メール、顧客のウェブサイト上のフォーム、担当者、または別のワークフローです。
- 各ステップと、その待機条件:何も不要、支払いのみ、またはすべての変更やメッセージです。
- 各ステップの経路:顧客に問い合わせる、別のステップへ進む、ルールテーブルに従う、担当者にケースを引き継ぐ、または終了します。
- ルールテーブルは「これが該当すれば、あれを実行」という形の行で構成されます。
- 返信元のアドレス、署名、および AI の開示記載行です。
それをワークフロー内に構築します。各ワークフローにはケース、ステップおよび設定、ルールテーブルはルールテーブルの下で共有されます。実行試用する公開前にステップで試用できます:試用すると実際には何も送信・変更されません。その後公開および有効にする。参照MCP経由のワークフロー。
レビュー規則
顧客と相談して、この顧客のコードにおいて CoRoid のレビュー担当者が確認すべき点を決めます。それは CoRoid 自身のルール以外の内容です。
各リポジトリにルールを記述します:ルートディレクトリにREVIEW.mdファイルを、review-rulesフォルダ内にルールファイルを配置します。CoRoid はベースブランチからこれらを読み込むため、pull request がレビュー対象のルールを変更することはできません。CoRoid レビューが投稿される場所を設定します。品質管理、プルリクエストの下にあります。参照プルリクエスト。
スキル
スキルとは、作業に必要な場合にのみエージェントが読み込む手順のことで、「データベース移行の書き方」などが該当します。顧客と相談して、エージェントが従うべき自社の手順を決めます。
各スキルをリポジトリ内にskills/<name>/SKILL.mdとして記述します。そのファイルはnameおよびdescriptionを含むフロントマターで始まります。エージェントはマージされたリポジトリからのみスキルを読み込みます。参照段階的スキルおよびAGENTS.md を作成する。
コードを書かずに変更できる項目
顧客や実装者は CoRoid のソースコードを取得できません。顧客が変更できるのはすべてこの表に記載されており、ポータル内の設定や顧客自身のリポジトリ内のファイルです。ワークフローなど、CoRoid で機能が有効になっている場合にのみ表示されるページもあります。
| 何 | どこ |
|---|---|
| 組織名 | 設定 → 一般 |
| メンバーとその役割 | 設定 → メンバー |
| AI プロファイル | 設定 → AIプロファイル |
| プロバイダーキー | 設定 → プロバイダーキー |
| 作業受付用のサービスアカウント API | 設定 → サービスアカウント |
| Gitホスト接続 | 設定 → 接続 → ソースコントロール |
| SlackおよびTelegramボット | 設定 → 接続 → チャネル |
| 外部MCPサーバーおよびエージェントが呼び出せるツール | 設定 → 接続 → 外部MCP |
| CoRoid のMCPサーバーのアクセストークン、承認、自動化ポリシー | 設定 → 接続 → CoRoid MCPサーバー |
| SSO、検証済みドメイン、ディレクトリ同期 | 設定 → IDおよびアクセス → エンタープライズID |
| 許可されるモデル、プロバイダー、コマンド、ツール | 設定 → IDおよびアクセス → 組織ポリシー |
| サインイン済みセッション | 設定 → IDおよびアクセス → 有効なセッション |
| 監査ログとそのエクスポート | 設定 → IDおよびアクセス → 監査ログ |
| プラン、エージェントスロット、モデルクレジット | 設定 → 請求および利用状況 |
| ストレージ、データ保持期間、設定のエクスポート | 設定 → データと法務 |
| プロジェクト名、リポジトリ、ブランチ、モード | プロジェクトの設定 → 一般およびリポジトリ |
| プロジェクトの環境変数 | プロジェクトの設定 → 環境変数 |
| エージェントがプロジェクトについて読み取る情報 | プロジェクトの設定 → ナレッジ → コンテキスト |
| 顧客のツールからのレビュー証拠 | プロジェクトの設定 → 連携 |
| チェック項目、品質管理、リクエスト元、プルリクエスト、「何かが壊れた時」 | 品質管理 |
| スロップ防止ルールおよび週次の技術負債清算 | 品質管理 |
| マンデート | 品質管理 → 組織デフォルト → デリバリー |
| セキュリティ保護、脅威モデル、攻撃面 | セキュリティ → プロジェクト |
| 言語、翻訳チェック項目、貢献者 | グローバリゼーション |
| リリース環境、承認ルール、デプロイパイプライン、バージョニング | リリース → リリース設定 |
| イベント自動化およびスケジュール | ファクトリー → 自動化、新規作業 |
| スケジュール済みレポート | ファクトリー → レポート |
| ワークフローおよびルールテーブル | ワークフロー |
| エージェント指示 | AGENTS.mdおよびリポジトリ内の他のメモリファイル |
| レビュー規則 | REVIEW.mdおよびreview-rulesフォルダ内の |
| スキル | skills/<name>/SKILL.mdリポジトリ内の |
そのCoRoid MCPサーバーアシスタントを通じて、有効なツール内でこれらの設定の多くが変更されます。
どのソリューションも対応できないニーズです。
テーブルの行がいずれもルールに該当しない場合は、製品に合わせて対応するのではなく、 CoRoidへ要求として送信してください。お問い合わせページ記載内容:
- 顧客データを含まない顧客の状況です。
- 上記の設定で試した内容です。
- 顧客のニーズとその理由です。
CoRoidによる変更は、リリース時にすべての顧客に適用されます。
完了条件:
- ディスカバリ文書内の各ルールには、設定またはCoRoidへの要求が定義されています。
- 各決定には、メモに理由が記載されています。
- 各プロジェクトの1つのタスクが、チェックを経てpull requestに到達します。