paperclip-record-strategy

Paperclipの計画チェーンを記録する

不足しているPaperclipの計画チェーンを作成するか、選択します。

Goal tree -> linked Project -> Parent Issue + plan document

参照資料

まず、次の資料を読んでください。

• references/CONTEXT.md
• references/docs/paperclip-operator/control-plane.md
• references/docs/paperclip-operator/workflow.md
• references/docs/paperclip-operator/cli-contract.md
• references/docs/paperclip-operator/integration-matrix.md

これらのプロジェクトドキュメントが見つからない場合は、最初にpaperclip-setupを実行して、同梱テンプレートから作成してください。

手順

1. 承認済みの確認事項の要約があることを確認します。
2. 現在のPaperclipのコンテキストと会社を確認します。
3. integration-matrix.mdのCLI優先の手順に従って、既存の目標とプロジェクトを一覧表示します。
4. オペレーターと相談し、次のどれに該当するかを判断します。
   • 新しいルート目標または子目標
   • 既存の目標
   • 既存の目標の下に新しいプロジェクトを作成
   • 既存のプロジェクト
   • 既存のプロジェクトの下に新しい親Issueを作成
5. 提案する計画チェーンの下書きを作成します。
6. Paperclipに変更を加える前に、承認を求めます。
7. 承認された不足分のみを作成または更新します。
8. 作成されたGoal、Project、Parent Issueと、計画ドキュメントへのリンクまたは識別子を報告します。

Wikiの参照資料

承認済みの確認事項の要約またはオペレーターのプロンプトにPaperclipのWiki URL、Wikiページのパス、または取得済みのWikiソースが記載されている場合は、計画チェーンまたは計画ドキュメントの下書きを作成する前にpaperclip-wiki-fetchを使用してください。取得したページのタイトル、パス、更新日時、ハッシュが利用可能な場合は、計画のソースノートに記録し、Markdown本文を参照資料として使用します。

Wikiの認証情報、会社のスコープ、Wiki ID、スペーススラッグ、またはページパスが不足しており、Paperclipのコンテキストから推測できない場合は、取得していないWikiの参照から下書きを作成せず、処理を中断して不足している情報を尋ねてください。

オペレーターから、作成した戦略成果物をWikiに公開または同期するよう明示的に依頼された場合は、まずPaperclipの計画チェーンの提案を完了してから、Wikiの変更にpaperclip-wiki-manageを使用してください。親Issueのplanドキュメントを、既定の信頼できる情報源としてのWikiに置き換えないでください。

目標のフィールド

Paperclipの目標には、ネイティブのlevel、status、parentId、ownerAgentIdフィールドがあります。この構造をタイトルに集約しないでください。

既定の割り当て：

• companyは、会社全体の持続的な最終成果に使用します。会社の北極星となる目標には、アクティブなルート会社目標を優先してください。
• teamは、チーム、機能、活動、チャネル、ドメイン、または戦略に関する持続的な子目標に使用します。parentIdには親の会社目標またはチーム目標を設定します。
• agentは、特定のPaperclipエージェントが目標を担当する場合に限り使用します。ownerAgentIdを設定します。
• taskは、まれに使用します。キャンペーン、月次計画、スプリント、リードリスト、草稿作成作業、実行可能なタスクにはIssueを優先してください。

目標の変更を提案する際は、承認前に必ずtitle、level、status、parentId、ownerAgentIdを提示してください。

サーフェスルール

ツールを選ぶ前に、integration-matrix.md を読んでください。

このスキルでは、次のようにします。

• 正確なネイティブフィールドに対応しており、結果を検証できる場合は、まず CLI を使用します。
• CLI に操作がない場合や、脆弱な解析が必要になる場合は、専用の Paperclip MCP ツールを使用します。
• ネイティブの paperclipai goal create/update、project create/update、および issue コマンドが存在し、その JSON の読み戻しで必要なフィールドを検証できる場合は、これらを使用します。
• インストール済みの CLI や専用 MCP ツールで公開されていないネイティブフィールドに限り、MCP paperclipApiRequest を使用します。
• CLI と MCP が利用できない、または機能しない場合に限り、直接 REST を使用します。
• 親 Issue の plan には、キー付き issue ドキュメントを使用します。利用可能な場合は、まず paperclipai issue document:get、document:put、document:revisions を使用し、その後に MCP ドキュメントツールを使用します。

最初の MCP API リクエストまたは直接 REST による変更を行う前に、次の手順を実施します。

1. paperclipai context show --json から apiBase と companyId を導出します。
2. paperclipai auth whoami --json を実行し、アクティブな認証ソースを確認します。
3. 必要に応じて、秘密情報を表示せずに ~/.paperclip/auth.json に保存されたボード認証情報の形式を確認します。
4. 書き込みの前に、対象の読み取りパスが機能することを確認します。

ベアラートークンは絶対に表示しないでください。認証情報を導出できない場合は、戦略成果物の作成方針を変更するのではなく、処理を中止して必要なコンテキストをオペレーターに尋ねてください。

戦略計画ドキュメント

対応している場合は、戦略成果物に親 Issue の plan ドキュメントを使用します。

推奨する計画の形式：

## Outcome

## Why This Matters

## Success Criteria

## Scope

## Non-Goals

## Constraints

## Risks

## Autonomy Level

## Validation

## Stop Conditions

## Planning Notes

利用可能な場合は、paperclipai issue document:put <issueId> plan --body-file <path> --json を使用します。更新時は、現在のドキュメントを読み取り、そのベースリビジョン ID を渡して、古い状態での書き込みが 409 Conflict で失敗するようにします。CLI でキー付きドキュメントを書き込めない場合は、MCP ドキュメントツールを使用します。専用の MCP ツールが利用できない場合は、paperclipApiRequest を使用し、使用したパスを説明します。CLI、MCP、API のすべてが利用できないか、オペレーターによって明示的に拒否された場合に限り、最後の手段として親 issue の説明に計画を埋め込みます。

変更ルール

Paperclip を作成または更新する前に、提案する Goal、Project、Parent Issue、および計画本文を必ず提示します。