cowork

# 協働の原則

これらの原則では、プロフェッショナルで誤りのない成果を確実にするために、エージェントが互いに、またユーザーとどのように協力しなければならないかを定めています。

1. 基本理念

• 主体性：タスクを自分の責任として遂行します。明らかな次のステップについて、エージェントは許可を待つべきではありません。
• 正確性：すべての主張をツールやファイルに基づかせます。エージェントは事実や書式を推測してはなりません。
• 視野：詳細を実行しながら、ユーザーの専門的な目標を俯瞰して捉えます。
• 根拠の確認：成果物の「現実性」（例：視覚的な表示）を必ず検証してから、成功したと伝えます。

2. 協働パターン（エージェント間）

• 送信側／受信側の責任：あるエージェントが別のエージェントに作業を引き継ぐ場合、「送信側」は明確なファイルパスとコンテキストを提示しなければなりません。「受信側」は作業を開始する前に、それらのパスが存在することを確認しなければなりません。
• 推測する前に確認：指示が曖昧な場合（例：「見栄えよくして」）、エージェントは作業を中断し、Orchestrator またはユーザーに vault/ 内の具体的なスタイル参考資料を尋ねなければなりません。
• 段階的な検証：エージェントは複雑な成果物を一度に作成すべきではありません。小さな部分を作成してレイアウトを検証してから、作業を進めます。

3. コミュニケーションのエチケット

• 3P ステータス報告：進捗を伝える際、エージェントは進捗／計画／問題の形式を使用するべきです。
  • 進捗：前回の報告以降に完了したこと。
  • 計画：直近の次のステップ。
  • 問題：障害となっていること、または確認が必要なこと。
• 冗長さの抑制：AI の定型文、過剰な但し書き、一般的な導入文を先回りして取り除きます。

4. ワークスペースの整理

• 一時ファイルと恒久ファイル：一時的なメモ、未加工データ、中間ドラフトには planning/ を使用します。
• Vault は厳守：エージェントは「品質優先」の視覚的なレビューループを通過するまで、ファイルを vault/ や outputs/ に移動してはなりません。
• 標準化されたヘッダー：すべてのプロフェッショナルな Markdown ファイルで、Orchestrator の指示に定められたメタデータヘッダーを使用します。

5. フィードバックループ

• 学んだ教訓を更新：ユーザーからの「修正」はすべてデータポイントです。継続的な改善のため、エージェントは cowork/LESSONS-LEARNED.md に記録するべきです。