参考資料を添付する

Chorus での仕事は、単独で成り立つことはめったにありません。あなたが従っている公式ドキュメント、手本にしているリポジトリ、問題を提起した issue のスレッド、あるいは着想の元になった記事に寄りかかっています。参考資料 は、その根拠をリンクとして捉えます。URL、タイトル、そしてなぜ重要かの任意のメモです。Chorus はそのリンクとあなたのメモだけを保存します。URL の先のページを取得・ダウンロード・スナップショットすることは決してありません。

参考資料は 着想、提案、または 課題 に添付でき、根拠がそれを支える仕事のすぐそばに置かれます。エージェントが課題を引き取ると、あなたが添えた参考資料はそれと一緒に付いていきます。そしてエージェントが計画を提案するとき、それは拠り所にした出典を、あなたが確認できるように添えられます。

参考資料を追加する

着想・提案・課題を開き、その 参考資料 の節（提案パネルではカード、課題と着想では見出し付きの節）を見つけます。参考資料を追加 を選び、次を記入します。

• 種類 — 四種のうちの一つで、それぞれ独自のアイコンとバッジで示されます。
  • ドキュメント — 公式のドキュメント。
  • リポジトリ — 参考実装またはコードベース。
  • Issue / PR — issue または pull request のスレッド。
  • 論文 / ブログ — 論文またはブログ記事。
• URL — ウェブのリンク（http:// または https://。ローカルファイルは受け付けません）。
• タイトル — 参考資料の短い名前。
• メモ — 任意。なぜその参考資料が関連するかを、簡潔な一文で。表示は二行に収まるよう切り詰められるので、短くしてください。全文はホバーで見られます。

参考資料はすぐに節に現れます。どの参考資料も同じ場所から編集・削除できます。削除するとリンクは Chorus から取り除かれ、元に戻せません。

エージェントは参考資料をどう使うか

エージェントはあなたと同じやり方で参考資料を添付します。だからこそ提案は、その出典に最初から根拠づけられた状態で届きます。document:write 権限を持つエージェントは三つのツール、chorus_add_reference、chorus_update_reference、chorus_remove_reference を持ち、着想・提案・一組の課題を作るときにインラインで参考資料を添えることもできます。実体を読む人は誰でも、その参考資料をインラインで見られます。特別な権限は要りません。

エージェントに出典を挙げるよう促すのは、身につける価値のある習慣です。狙った API ドキュメントそのものをリンクした提案は、鵜呑みを求める提案よりもはるかに検証しやすくなります。これらのツールを門番する権限が、より大きなモデルの中でどう位置づくかは認証参考を、ツール自体は MCP ツール参考をご覧ください。