cco-patterns

CCO パターン — プロジェクトで得た知見を共有する

パターンはマシンごと、プロジェクトごとに学習されます。通常、どのファイルが無駄になるのか、どのファイルが役立つのか、どのファイルが一緒に編集されるのか、といった知見です。チームメイトが新しくクローンすると、何も知らない状態から始まり、同じトークンを無駄に使って同じことを学び直します。

これにより、パターンを持ち運べるようになります。プラグインのルート（src/patterns-share.js があるディレクトリ）から実行してください。

$ARGUMENTS を解析します。

export

node ${CLAUDE_PLUGIN_ROOT}/src/patterns-share.js export

プロジェクト内に .cco/patterns.digest.json を書き込みます（--out で上書きできます）。

ダイジェストには相対パスとカウントのみが含まれます。ファイルの内容、絶対パス、ホームディレクトリは含まれません。プロジェクトのルートからの相対パスとして表現できない項目は除外され、その件数が報告されます。書き込み前にファイルを監査し、識別につながる情報が紛れ込んでいた場合は、誰かがコミットする可能性のあるファイルを生成する代わりに、書き込みを拒否します。

このダイジェストは安全にコミットでき、コミットすることが目的であるとユーザーに伝えてください。そうすれば、チームメイトはクローン時に受け取れます。

import <file>

node ${CLAUDE_PLUGIN_ROOT}/src/patterns-share.js import .cco/patterns.digest.json

現在のプロジェクトのパターンにマージします。インポートしたデータは別個の事前情報として保存され、ユーザー自身のカウントには一切触れません。

これは重要なので、はっきりと伝える価値があります。confidence は、このマシンがあるファイルを何回のセッションで観測したかに基づいて計算されます。他の人のセッションをその数に加えると、ユーザー自身の確信度が実態にそぐわなくなります。そのため、インポートによって情報が補われるのは、ユーザー自身の観測がない場合、つまり新しくクローンした場合だけです。常にローカルの証拠が優先されます。

ダイジェストは外部から取り込む際にも監査されます。絶対パスやパストラバーサルの要素が含まれるファイルは、サニタイズせずに拒否されます。

show

node ${CLAUDE_PLUGIN_ROOT}/src/patterns-share.js show

このプロジェクトにインポートされた内容と、各ファイルに付けられたラベルを一覧表示します。

提案するタイミング

次のような場合に提案するとよいでしょう。

• ユーザーがチーム向けにリポジトリを準備していて、オンボーディングのコストについて尋ねている。
• プロジェクトに意味のある無駄の履歴があり（/cco-shield に繰り返し発生する問題が表示される）、チームメイト全員がそうでなければ同じことを再発見することになる。
• .cco/patterns.digest.json がすでにあるリポジトリを誰かがクローンしたばかりで、そのインポートを提案する。