プライバシーとデータ管理

これはリポジトリの運用方針です。入力がすべて端末内に留まるという保証ではありません。 個人の取引データを使う前に、スキルの処理、ツール権限、接続先の規約を確認してください。 口座識別子、保有明細、税務資料、APIキー、未加工の会話は、意図した開示でない限り、 公開サンプル、Issue、PR、モデルへの入力に含めないでください。架空の例に置き換え、 識別情報を除き、派生した文章も確認してください。切り詰めは匿名化ではありません。 全般的なPII(個人識別情報)の自動除去機構はありません。 レポート、ログ、事後検証を共有する前に、氏名、口座番号、注文ID、ブローカー識別子を 架空のラベルに置き換え、自由記述、ファイル名、メタデータにも識別情報がないか確認します。 レビューに必要な項目だけを共有してください。

ローカル保存とGitの境界

場所 保存され得る情報 扱い
state/theses、state/journal 投資仮説、保有、判断、取引結果 非公開。変更前にバックアップ
reports/、reviews/ ポートフォリオ分析、生成レポート、レビュー結果 原則非公開。共有前に内容を確認
logs/、.cache/、.staging/ 診断、プロバイダー応答、自動化状態、中間生成物 機微な応答やエラー抜粋を含む可能性
.env、.env.*、.envrc*、.mcp.json*、.aws/、.ssh/ 認証情報、ローカル接続設定 OSのアクセス権で保護。公開禁止
.claude/、~/.claude/projects/ エージェント設定、会話履歴 ユーザー入力・ツール応答を含む。マイニングの説明を参照
private-backups/ 復旧用コピー、ハッシュ一覧 アクセス制限。端末外のコピーは暗号化

ルートの .gitignore は、これらのリポジトリ内の標準保存場所を除外します。 check_private_data_paths.py は、実際のGitインデックスに含まれるルートの state、reports、logs、reviews、 .cache、.claude、.staging、private-backups、.aws、.ssh、dotenv・.envrc 系、 .mcp.json 系のパスを拒否します。強制追加と大文字小文字の違いも対象です。 例外は、正確に一致する通常ファイルで、インデックス上でも空の state/journal/.gitkeep と state/theses/.gitkeep のみです。 pre-commitと既存のルートスクリプトCIテストで確認します。貢献前にフックを導入してください。 CIは、すでにpushされた秘密を取り消すものではありません。

このガードが確認するのはパス名とGitオブジェクトのメタデータです。 examples/、docs/、テスト配下の確認済み架空データは許可され、そこに置かれた実データを 内容から検知する機能はありません。ignoreは暗号化、履歴削除、アップロード防止、 リポジトリ外の絶対パスの保護にはなりません。別のdetect-secretsフックもMarkdown、JSON、CSV などを除外しており、秘密・PIIの完全な検査ではありません。キーが漏れた場合は接続先で 失効・ローテーションし、履歴や生成物への影響も別途確認してください。

外部へのデータフロー

接続 送信・参照されるデータ 応答と境界
FMPクライアント 銘柄、日付、条件、APIキー(エンドポイントに応じヘッダーまたはクエリ) 市場データ。生の応答がキャッシュ・出力に残り得る
FINVIZ スクリーニング条件、設定した認証キー 検索結果
Alpacaツール・ポートフォリオ全体のワークフロー ブローカー認証による口座・保有照会。応答がモデル文脈に入る可能性 口座・保有データ。ローカルCSV比較・正規化コマンドはオフラインだが、別ツール接続で境界は変わる
WebSearch・ブラウザ 検索語、銘柄、検索文に含めた入力 外部ページ。検索語に口座情報を含めない
Claude・設定したモデル 会話、貼付ファイル、文脈に選ばれたツール応答、下記マイニング・レビュー用プロンプト モデル出力。接続先の保持・アクセス設定も確認
GitHub自動化 選択した候補、スキル変更、PR文、コミットしたファイル 公開され得る。派生物や成果物も公開前に確認

通信の保護は設定したエンドポイントとツールに依存します。HTTPSを使い、キーをログや プロンプトに記載しないでください。すべての通信経路に自動マスキングがあるわけではありません。 ブローカー利用に関するスキルの指示は、あらゆる注文実行を技術的に遮断する仕組みではありません。 実際のツール機能・権限を確認してください。オフライン処理は外部接続ツールの利用許可を意味しません。

会話履歴マイニングは個別に判断

mine_session_logs.py は、選択した ~/.claude/projects/ のプロジェクトディレクトリ直下の *.jsonl を読みます。 通常は更新日時が過去7日以内のファイルです。既定の対象は claude-trading-skills、 claude-market-agents、trade-edge-finder、trade-strategy-pipeline、weekly-trade-strategy です。--project 指定は対象を変更・拡張できます。すべてのCodex履歴フォルダーを走査する処理ではありません。

外部ユーザーメッセージ、assistantのツール名・入力、ツール結果・エラーを解析して兆候を抽出します。 サイドチェーンと不正なレコードはスキップします。モデル向けプロンプトにはプロジェクト名、 パターン、選ばれたユーザー抜粋最大5件(各200文字)、各兆候のサンプル最大3件(各100文字) が入り得ます。claude -p に標準入力で渡し、最大3ターン、予算1米ドル、タイムアウト600秒で 実行します。この制限は匿名化ではありません。個人情報を含む履歴で実行する前に、同意と内容を確認してください。

--dry-run はモデルによる抽象化を省きますが、ローカル履歴の読取・解析と派生候補の保存は行います。 生候補やセッション詳細にも機微な内容が残り得ます。 週次生成パイプライン はマイナーを呼び出し、後続の生成・バックログ・PR処理で派生物が公開される場合があります。 改善ループ もスキル・レビュー用プロンプトを claude -p に送ります。どちらもPII除去を保証しません。 スケジュールを停止するだけでは、既存の履歴や生成物は消えません。

保持方針と現在の自動処理

運用上の目標は、通常の診断ログは30日以内、レポート・履歴抜粋は必要最小限とし、 調査証跡はレビュー・復旧に必要な期間だけ保持することです。不要な非公開ファイル・コピーは 運用者が確認して削除し、削除前にバックアップの必要性を確認します。 プロバイダー側の保持期間は、接続先・アカウント設定に従う別の問題です。

現在の実装では、生成・改善スクリプトが削除するのは logs/ 直下の30日を超えた *.log のみで、それぞれの状態履歴は60件に制限されます。下位ディレクトリのログ、JSON状態、レポート、 キャッシュ、Claude履歴、バックアップには、統一された自動削除はありません。 方針を実装済みの機能として扱わず、作業中・未確認の証跡に一括削除を実行しないでください。

復旧訓練には検証対象のバックアップ・復元手順 を使います。書込み停止、非公開の保存先、新規出力先、全ファイル一覧・SHA-256の一致、 読取り専用 doctor の成功を確認します。テストは架空データの元ファイル喪失後に復元するもので、 利用者自身のバックアップを保証しません。 SECURITY.md に報告経路の制限とサポート方針を記載しています。ここでの機能記述は2026-11-14のソース確認に基づき、 公開サイトの反映状況・プロバイダー設定とは異なる場合があります。