来歴

来歴とは、1つの作業（タスク、プラン、プランのタスク、または作業パッケージ）に関する記録です。マージ後に変更がどこから来たのか、誰が依頼したのか、誰が所有しているのか、誰が何をどう決定したのか、そして何が納品されたのかという問いに答えます。

Coroidは、ファクトリー内で作業が進む過程で既に発生している情報をもとに来歴を作成します。つまり、作業開始のきっかけとなった会話やリクエスト、関係者が承認した文書、下された決定、そして納品に至ったプルリクエストやコミットです。ポータル、プルリクエスト、コミット内でも同じ記録を確認でき、作業を担当するエージェントもこれを参照します。

来歴が答える内容#

• 出所作業の発端となったもので、それへのリンクが付随します。チャットでの会話、Prepare Workレビュー、新規作業リクエスト、インポートまたはWebhookで生成された課題、フック、スケジュール、MCPクライアント、API、調査結果や報告書、親プランやタスクなどです。
• 依頼者とオーナー作業を依頼した人と、現在それを所有している人です。サービスアカウント経由で作業が届いた場合や、組織外の人物（例えばGitHub課題の作成者）からの依頼の場合、来歴にはそのアカウント名や人物名が記載されます。Coroidは推測でメンバー名を入力することはありません。
• 決定事項承認、変更リクエスト、開始・停止・再試行・マージ・上書き・所有権変更などで、それぞれ誰がいつ行い、理由があればその内容も記載されます。
• 議論作業の形成に影響を与えた人々のメッセージです。作業の発端となった会話や文書へのフィードバックからの抜粋で、それぞれ作成者とリンクが付随します。
• 納品プルリクエスト、コミット、QAの判定結果、レビュー決定、およびその証拠です。

プランに属するタスクは、そのプランの出所と依頼者を共有します。また、来歴にはそのタスク、所属するプランや作業パッケージ、そしてそれらの発端となった会話やリクエストも記載されます。

まずは要約から#

来歴を表示する画面はすべて最初に要約が表示されるため、作業の目的と関与者を一目で確認できます。

• 意図作業の内容とその理由で、短い段落で記載されます。承認済みの意図、次に承認済みの仕様書、次に元のリクエスト、最後にタスクやプランの説明から引用されます。その下にはそれがどこから来たかが記載されます。
• 依頼者依頼した人物、サービスアカウント、または外部の人物です。
• オーナー現在作業を所有している人です。最後に権限が移譲された人物、またはタスクが割り当てられている人物、作業の発端となった会話のオーナー、依頼者の中から選ばれます。
• 承認者作業の意図、仕様書、実装プラン、およびプラン自体を承認した人々で、それぞれ承認した役割が記載されます。
• 主要な決定事項最新の決定事項最大5件で、それぞれ理由が付随します。

記載されている承認者は常に人間です。Coroidが自動的に記録した承認は除外されます。詳細は自動的な決定事項。

確認できる場所#

ポータル内#

ファクトリーでタスクまたはプランを開き、来歴セクションを展開すると、要約の下に以下の項目が表示されます。

• 出所作業の出所で、会話、リクエスト、課題、または報告書へのリンクが付随します。
• 系譜タスクがプランに属する場合、そのプランや作業パッケージが記載されます。
• 決定事項古いものから順に表示され、それぞれ理由が付随します。履歴が長い場合は最新の8件のみが示され、さらにクリックすると残りの内容を確認できます。
• 議論作業の形成に影響を与えたメッセージで、最新のものから順に表示されます。
• 納品プルリクエストとそれをマージした人、コミット、QAの判定結果、レビューおよびその証拠です。

タスクの詳細タブやプランのプロモーションレビューには簡易版が表示され、完全な来歴へのリンクが付随します。

アクセス権は作業自体に紐づきます。タスクの来歴を確認するにはそのプロジェクトへの読み取り権限が必要で、プランの来歴はプランと同様に組織全体で閲覧可能です。

プルリクエスト内#

すべての pull request Coroid には、タスクやプラン、リリースを問わず、来歴セクションが含まれます。このセクションはまず、意図、作業内容、依頼者、オーナー、承認者、重要な決定事項という同じ要約から始まります。次に起源とそのリンク、続いて系譜、決定事項、納品内容、そして Coroid で作業を開くためのリンクが記載されます。

Coroid は他のセクションをその周囲に記述します。変更の要約、タスクおよびそのレビュー証拠へのリンク、受け入れ基準、QAおよびレビュー状況などです。

Coroid が所有するのは、説明内に非表示コメントでマークしたセクションのみです。例えば再作業後に pull request を更新する際、これらのセクションだけを置き換え、あなたやレビュアーが記述した他の内容はそのまま保持します。履歴が長すぎて収まりきらない場合は、最も古い決定事項から削除され、セクション内に「詳細は Coroid に記載」と記載されます。

リリース pull request には、バンドルされた各 pull request が一覧表示されます。納品内容、依頼者、承認者がマージ順に記載されます。

コミット内では#

Coroid が作成するすべてのコミットの末尾には、該当する作業を特定するトレイラーが記載されます。

Coroid-Task: 3f6e2b1c-7d4a-4c1e-9b2f-0a8d5e6c7b91
Coroid-Plan: 8a41b7c3-25d0-4f6b-a1e9-6c3d2b7f4e05
Coroid-Requested-By: Maya Lindqvist
Coroid-Origin: prepare_work

作業の種類によっては、コミット内にプランタスク、ワークパッケージ、エージェント実行結果、パッチ、リリースも記載されます。依頼者を示すトレイラーには名前が記載され、メールアドレスは含まれません。

Coroid は自身が作成するすべてのコミットのコミッターとなります。人の接続アカウントでコミットが作成された場合、Coroid は共同著者としても追加されます。

Co-authored-by: Coroid <ai@coroid.ai>

Coroid は各コミットと対応するタスクまたはプランのマッピングも保持します。Coroid が開いた pull request が GitHub または GitLab にマージされると、Coroid はマージまたはスクワッシュコミットを記録するため、スクワッシュマージでもリンクが失われることはありません。

エージェント向け#

各エージェントがタスクを処理する際の作業指示書には、その来歴が記載されています。つまり、なぜその作業が存在し、誰が依頼し、誰が責任を持ち、どのような決定が下されたかが明記されています。エージェントがさらに詳細な情報を必要とする場合は、該当するセクションを1つずつ確認できます。

仕様書が依然として優先されます。来歴と仕様書が一致しない場合、エージェントは仕様書に従い、黙って選択せずにレポート内に矛盾を記載します。人が記述したメッセージや理由は、エージェントが読み取る前に Coroid のプロンプトインジェクションフィルターを通過し、フィルターで除外されたテキストは保持されません。

Gitホストに送信されない情報#

会話のテキストは pull request やコミットに記載されることはありません。pull request には名前、役割、決定事項、理由、リンクが含まれます。議論内容はメッセージ数と執筆者名のみで表示され、Coroid 内の会話へのリンクが付随します。メールアドレスは記載されず、人物は名前で示されます。

リンクのみ#

デフォルトでは、pull request の来歴セクションには意図の段落、重要な決定事項、人々が述べた理由が含まれます。組織によっては「リンクのみ」を選択できます。この場合、セクションには依頼者、作業のオーナー、承認者、決定事項、Coroid へのリンクのみが残り、意図の段落、重要な決定事項、すべての理由は除外されます。

製品の背景を知るべきでない人がリポジトリを閲覧できる場合、例えば公開リポジトリの場合に「リンクのみ」を選択してください。この設定は、選択後に関係する Coroid が開くまたは更新する pull request に適用されます。現在のところ設定画面はありません。お問い合わせ組織を「リンクのみ」モードに切り替えるには、こちらまでご連絡ください。

決定事項とその理由#

Coroid は作業進行中に決定事項を記録します。意図、仕様書、プランの承認、Qualification、手動での作業開始・停止・再試行・完了、マージや強制マージ、ゲートの上書き、リリース承認、会話の参加者やオーナーの変更、QAおよびレビュアーエージェント、コーディネーターの判定などです。

プランを承認して開始したり、タスクを停止したり、タスクを再試行したりする際、確認画面で最大2,000文字の任意の理由を入力できます。この理由はあなたの名前と共に作業の来歴に保存され、組織が「リンクのみ」を使用していない限り pull request にも表示されます。一文で十分です。「春のキャンペーン前に顧客が要望していた」といった記述は、承認事実だけよりも次の読者に多くの情報を伝えられます。強制マージの場合も書面での理由が必須であり、同様に記録されます。

自動決定事項#

一部の決定事項は、関係者が行うのではなく代わりに記録されます。プランタスクの納品契約は承認済みのプランに基づき自動的に承認され、人物なしで承認されたプランには作成者が代行します。タイムラインではこれらの決定事項を「自動」とラベル付けし、人の承認とはみなされません。

QAやレビューの判定、コーディネーターの決定など、エージェントが下した決定事項は、エージェントの名前の下にその要約と共に表示されます。

実行中のタスクにコンテキストを追加#

タスク実行中にエージェントに情報を伝えることができ、タスクを停止する必要はありません。タスクの「アクティビティ」タブを開き、進行中のアクティビティ横にある「コンテキストを追加」を選択します。エージェントが把握すべき内容を最大2,000文字で入力し、確定してください。

• エージェントが実行中の場合、次の処理サイクルでユーザーのメッセージを読み取ります。他のエージェントを待機中のコーディネーターも、そのメッセージを読むために起動します。
• エージェントが実行中でない場合、次に開始されるエージェントがそのメッセージを読み取ります。

このメッセージはタスクの来歴に「コンテキストが追加された」という決定事項として、ユーザー名と共に記録されます。タスクの納品物には影響しません。メッセージが仕様書と矛盾する場合、エージェントは黙って判断するのではなく、その矛盾を報告します。結果を変更するには、仕様書を修正するか、タスクを再作業として戻してください。

コンテキストを追加するには、タスクが属するプロジェクトへの書き込み権限が必要です。完了済みおよびキャンセル済みのタスクではこの機能を利用できません。

コードの来歴を特定する#

コードの行から出発して、それを作成した作業内容を特定できます。ポータル、エージェント、MCPクライアント、Gitがすべてこれを可能にします。

なぜここにあるのか？#

タスクのコードレビューにおいて、既存の行に変更を加えるハンクごとにこのボタンが表示されます。対象ブランチ上で最後にその行を変更したコミットを調べ、各コミットの由来を表示します。

• Coroidによって作成：タスクまたはプランであり、その意図、依頼者、承認者、主要な決定事項、そして完全な来歴へのリンクが含まれます。
• Coroid外で作成：タスクやプランが変更理由を記録していないため、作成者と日付のみが表示されます。

変更で追加されたファイルには以前の行がないため、このボタンは表示されません。

エージェントまたはMCPクライアントを使用して#

エージェントやMCPクライアントは、同じ問い合わせをツール経由で行います。このツールはファイルを対象とし、必要に応じて行範囲やブランチ、タグ、コミットを指定できます。そして、各行範囲が最後に変更されたコミット情報を返します。Coroidが作成したコミットの場合、それに対応するタスクや計画の内容や来歴もまとめて表示されます。このツールの名称はexplain_code。

• エージェント：CoroidのDeveloper、Reviewer、コーディネーターエージェントは、目的が不明なコードを変更または削除する前にこのツールを利用します。
• MCPクライアント：読み取り専用のツールであるため、Reviewerロールと以下のスコープが必要です：mcp.read。接続可能なプロジェクト内でのみ動作し、1分間に30回の呼び出しが許可されます。

Gitを使用して#

Coroidが作成する各コミットはトレーラーに作業内容を記載するため、Gitでも同様に該当箇所を特定できます：

git blame -L 120,120 src/search/alerts.ts   # the commit that last changed line 120
git log -1 <sha>                            # its Coroid-Task or Coroid-Plan trailer

その後、ポータルで該当するタスクまたはプランを開き、その来歴を確認してください：

• タスク：https://client.coroid.ai/factory/task:<task id>?panel=provenance
• プラン：https://client.coroid.ai/factory/<plan id>#provenance

マージまたはスクワッシュコミットの場合、それが由来するpull requestを開いてください。その来歴セクションにはCoroidへのリンクが記載されています。

来歴をエクスポート#

パネル上部に2つのダウンロードボタンがあります。Markdown形式では、要約を先頭にした来歴文書がダウンロードされます。これはpull requestセクションと同様の形式で、理由のみが記載され、会話テキストは含まれません。JSON形式では、議論の抜粋を含む完全な記録が自分用の記録やツール用にダウンロードされます。JSONファイルは、引用される会話と同様に非公開で保管してください。

由来が記録されていません#

Coroidは機能導入後に作成された作業の来歴を記録します。それより古い作業には、由来の代わりにこのメッセージが表示されます：

由来が記録されていません。この作業はCoroidが来歴を記録する前に作成されました。

Coroidが以前の記録からソースを把握している場合、例えばプランの由来となった会話や背後にあるレポートなど、パネルには既知のソースとして一覧表示されます。それ以前にすでに記録されていた決定事項、例えば文書の承認などは引き続き表示されますが、そうでないものは欠落している場合があります。

"Derived"とラベル付けされた由来は、作業作成時に捕捉されたのではなく、以前の記録から再構築されたものです。

関連項目#

• タスク
• プラン
• 結果をレビューしてマージする
• チャットアシスタント
• 仕様書
• CoroidをMCPサーバーとして