polpo

Polpo プロジェクト

チェックアウト済みのプロジェクトとインストール済みの CLI を正式な情報源として扱ってください。明示的に移行する場合を除き、従来の .polpo/polpo.json や .polpo/agents.json の構成を再作成しないでください。

ワークフロー

1. リポジトリ、.polpo/、package.json、インストール済みの polpo CLI のバージョンを確認します。
2. 既存のリンク済みプロジェクトは維持します。ユーザーから要求された場合、またはプロジェクトが存在しない場合にのみ、作成またはリンクします。
3. レイアウト v2 でリソースを作成します。プロジェクトメタデータ、エージェントごとのディレクトリ、プロジェクト Loop 定義、チーム、スキル、スキルのロックファイルを用意します。
4. デプロイ前にローカルで検証します。2 回目に同じデプロイを行うことに頼らず、不明な参照やパッケージ化の失敗を解決します。
5. CLI またはサポートされているワークフローを通じてデプロイします。プロジェクトファイルにプロバイダーのシークレットを配置しないでください。
6. プロジェクト、変更したリソース、実施した検証、Cloud のプロビジョニングまたはロールアウトが引き続き必要かどうかを報告します。

プロジェクトの境界

• OSS は、移植可能なコントラクト、スキーマ、ランタイムの動作、SDK、CLI の動作、セルフホスト用アダプターを担います。
• Cloud は、マネージドテナンシー、課金、ロールアウト、ホスト型ストレージ、プロバイダーの自動化、セキュアな認証情報の管理、マネージドな調整を担います。
• Cloud の機能では、セルフホスト型ランタイムに広く有用な動作に OSS のプリミティブを利用します。移植可能なランタイムの動作を、ダッシュボードのみの設定としてモデル化しないでください。

リファレンス

• .polpo/ ファイルを作成または移行する前に、references/project-layout.md を読みます。
• ブートストラップ、リンク、検証、デプロイ、プル、スキル、失敗時の動作については、references/cli-and-deploy.md を読みます。
• OSS と Cloud のどちらが担うべきかを判断するときや、マネージド環境のみで発生する動作を診断するときは、references/platform-boundaries.md を読みます。
• 異なる Polpo リリースで正確なフィールドやコマンドを利用する前に、references/contract-version.md を読みます。

専門スキル

• polpo-agents：エージェント定義、モデル、ポリシー、スキル、メモリ、サンドボックスのデフォルト設定。
• polpo-runtime：補完、Sessions、永続実行、Project Loops、ステアリング、スケジュール。
• polpo-channels：メッセージングプロバイダー、プロビジョニング、ルーティング、メディア、信頼済み ID。
• polpo-integrations：Connections、カスタムツール、非表示のバインディング、MCP、OAuth。
• polpo-react：React フック、チャット UI、永続的な再接続、インタラクション、クライアントツール。