Snowflake-Labs/cocoplus

CocoPlusとは？

CocoPlusは、SnowflakeのCocoプラットフォーム上に構築されたエージェント型オペレーティングシステムです。データエンジニアリングプロジェクト向けのフルスタックなマルチエージェントワークフローエンジンを追加し、初期仕様から本番リリースまでプロジェクトを導きます。このシステムは、Skills、Agents、Hooks、AGENTS.mdといったCocoネイティブの構成要素のみで作られており、すべてがSnowflake環境内で動作します。

---

中核となるアイデア

概念	平易な言葉での意味
エージェント型OS	単一のスクリプトがすべてを行うのではなく、データエンジニアリングジョブの一部を実行するために多くの専門化されたボット（エージェント）を調整する、小さな「オペレーティングシステム」と考えてください。
構造化されたライフサイクル	すべてのプロジェクトは、仕様 → 計画 → 構築 → テスト → レビュー → リリースというおなじみのフェーズに従います。各ゲートでは、システムが適切な証拠、コスト制限、ガバナンスルールが満たされているかを確認してから次に進みます。
動的ペルソナ	データエンジニア（$de）、データサイエンティスト（$ds）、データスチュワード（$dst）などの事前定義されたロールを、その場でインスタンス化できます。各ペルソナは独自のスキルセットと履歴を持ち、適切な専門家が各サブタスクを処理します。
ガバナンスフック	組み込みの安全ポリシーにより、明示的な許可リストで上書きされない限り、危険なSnowflakeコマンド（本番環境でのDROP TABLEなど）を停止します。
CocoConsole	$cocoplus consoleで起動する読み取り専用のブラウザベースのダッシュボードです。フロー、コスト、セッション情報、ポリシーログ、その他の可観測性データを表示します。
CocoPilot	オプションの自然言語制御 – $pilot on/offでオン/オフを切り替え、平易な英語で高レベルの指示を与えることができます。
CocoForge / Leviathan / Ronin	より高レベルのオーケストレーションモードで、エージェントのチームが目標に向かって自律的に協力したり、進捗状況を報告する「パーソナルアシスタント」スタイルのループを実行したりできます。
CocoWisdom	完了したセッションから教訓を抽出し、知識の照会や拒否を可能にし、エージェントが学習した内容の検索可能なログを保持するメモリシステムです。
CocoFlow	作業を計画、スコアリング、ディスパッチするエンジンです。競合検出、コスト予算編成、チェックポイント処理を処理し、任意の段階で人間の承認のために一時停止できます。
CocoRoutine	完了したフローをSnowflake TASKに変換し、スケジュールで実行できるようにします。

---

使用方法

1. インストール – Snowflake Coco CLIを介してプラグインをインストールします（cortex plugin install …）。
2. 初期化 – $pod initで新しいプロジェクトを初期化します。これにより、必要なフォルダ構造とAGENTS.mdファイルが作成されます。
3. システムを有効化 – $cocoplus on。
4. 仕様フェーズを開始（$spec）して要件を取得します。システムは、適切なペルソナエージェント（例：データプロダクトマネージャー）を起動して、明確化の質問をします。
5. フェーズを進める（$plan、$build、$test、$review、$ship）。各ゲートで、コンソールにコスト、証拠、ポリシー違反が表示されます。
6. オプションの自然言語オーケストレーション – $pilot onを有効にして、「ETLパイプラインのコストを最適化して」とシステムに指示します。基盤となるエージェントがそれを具体的なアクションに変換します。
7. ウィズダムを確認 – 実行後、$wisdom get <topic>でエージェントが学習したことを確認したり、$wisdom rejectで悪いアドバイスを拒否したりできます。
8. 定期的な作業をスケジュール – フローを定期的に実行する必要がある場合は、$routineを使用します。

---

誰が恩恵を受けるか？

対象	重要性
データエンジニアリングチーム	Snowflakeデータプロダクトの構築とリリースのための、再現可能で監査可能なパイプラインを提供し、コストと安全性のチェックが組み込まれています。
ガバナンスおよびコンプライアンスグループ	ポリシーフックがリスクの高い操作を自動的にブロックし、すべての決定のログを保持するため、監査が容易になります。
ML/AIプラットフォームチーム	同じエージェント型フレームワークをモデルトレーニングやフィーチャーストアのワークフローに拡張でき、同じ安全性と可観測性スタックを再利用できます。
DevOps / SRE	スケジューリング（CocoRoutine）とモニタリング（CocoConsole、$meterコマンド）により、データパイプラインの健全性に関する使い慣れた運用ビューが得られます。

---

制限事項 / 留意点

• Coco専用 – SnowflakeのCoco環境内で実行されます。cortex CLIと、CocoプラグインをサポートするSnowflakeアカウントが必要です。
• 複雑さ – システムは多くのコマンド（$flow、$meter、$adversary、$diaryなど）を定義しています。チームは全機能を採用するために学習曲線が必要になります。
• 安全ポリシーはオプトイン – デフォルトでは、自律的なリフレクションと一部のガバナンスフックは無効になっています。意図的に有効にする必要があります。
• オープンソースであり、Snowflake公式サポート対象外 – バグや欠落機能は、Snowflake自体ではなくコミュニティによって処理されます。

---

クイックスタートチートシート

# プラグインのインストール
cortex plugin install Snowflake-Labs/cocoplus
cortex plugin enable cocoplus

# 新しいプロジェクトの作成
$ pod init
$ cocoplus on

# 可観測性コンソールを開く（読み取り専用）
$ cocoplus console

# ライフサイクルを実行
$ spec          # 要件の取得
$ plan          # プランの生成
$ build         # ETL / モデルコードの実行
$ test          # テスト、コストチェックの実行
$ review        # 人間または自動レビュー
$ ship          # 本番環境へのデプロイ

# オプションの自然言語制御
$ pilot on
# これで「夜間ロードのコストを20%削減して」などと入力できます

# 定期的な実行のスケジュール
$ routine create my_daily_flow

---

ライセンスと法的情報

CocoPlusはMITライセンスの下でリリースされています。オープンソースであり、Snowflakeの公式製品ではありません。通常の「現状有姿」の免責事項が適用されます。

---

上記の情報はすべてリポジトリのREADMEから直接取得したものであり、外部の仮定は追加されていません。