TMCP

TMCP は、エージェントへの指示が散在している状態から、タスクに特化した運用パケットを作成します。ユーザーは作業内容を自然言語で説明します。TMCP はタスクを特定し、スキル／ルール／エビデンスから現時点で最適なパケットをコンパイルします。作業の変化に合わせて再コンパイルし、監査証跡を残します。

スキル名は由来を示すものであり、ユーザーインターフェースではありません。パワーユーザーは引き続きルートを強制できますが、デフォルトでは自然言語でプロンプトを入力します。

TMCP は、リポジトリのチェックアウト、コピーしたプラグインパッケージ、Codex プラグインキャッシュ、Claude プラグインキャッシュ、または同梱の Node エントリーポイントを起動できる MCP ホストから単独で実行できます。以前の AIOS アダプターは非推奨で、デフォルトでは無効です。AIOS_ROOT だけでは有効にならなくなりました。

適応型パケットランタイムの設計については、docs/ADAPTIVE_PACKET_RUNTIME.md を参照してください。

クイックスタート

TMCP のチェックアウトまたはプラグインルートから実行します。

node scripts/tmcp_launcher.mjs doctor
node scripts/tmcp_launcher.mjs status
node scripts/tmcp_launcher.mjs compose-packet "Improve this agent run" --project-path . --phase start
node scripts/tmcp_launcher.mjs harvest skills --limit 5 --no-write-artifacts
node scripts/tmcp_launcher.mjs recommend skills --candidate-workflows release_readiness --candidate-workflows developer_experience --min-confidence 0.1 --compose --no-write-artifacts

引数を指定しない場合、同じランチャーが MCP stdio サーバーを起動します。

node scripts/tmcp_launcher.mjs

インストール方法

• スキルのみのインストール：skills/tmcp をスキルディレクトリにコピーします。ホストが同梱のランチャーも公開していない限り、スキルをルーティングと手動でのパケット合成に使用します。
• リポジトリのチェックアウト：リポジトリをクローンし、チェックアウトルートから node scripts/tmcp_launcher.mjs doctor を実行します。
• Codex プラグインキャッシュ：Codex プラグインとしてインストールします。MCP 設定では、プラグインルートから相対パス scripts/tmcp_launcher.mjs を起動します。
• 共有ローカルランタイム：scripts/tmcp_runtime.mjs で検証済みアーカイブをインストールすると、すべてのエージェントホストで、オフラインでのロールバックに対応した、固定されたアクティブリリースを使用できます。中央ランタイムを参照してください。
• 非推奨の AIOS 互換性：TMCP_ENABLE_DEPRECATED_AIOS_ADAPTER=1 と AIOS_ROOT の両方が必要です。新規インストールでは、スタンドアロンの TMCP を使用してください。

Claude Desktop ユーザーは、ランチャーをローカルの stdio MCP サーバーとして追加できます。docs/CLAUDE_DESKTOP.mdを参照してください。

安定性の範囲

TMCP は、互いに独立した次の 3 つの領域を分類しています。

• スキルパッケージ： tmcp、skill-harvest、workflow-recommendation、release-readiness、dx-audit は安定したルーティングパッケージです。
• 厳選されたワークフローテンプレート： release-readiness と dx-audit は、推奨カタログ内の安定したテンプレートです。
• MCP ツールのコントラクト： doctor、status、explain、compose-packet、runtime-next は安定しています。Harvest、evaluation、recommendation、promotion、receipt、expert-rubric の各ツールは引き続き実験的です。

実験的なテンプレートとツールも引き続き同梱され、呼び出し可能です。安定したパッケージのルートと、安定したツールコントラクトまたは厳選されたテンプレートとを混同しないよう、それぞれの出力とフロントマターで実験的であることを明示しています。

実験的なワークフローには、UI ルーブリック、セキュリティ／プライバシー、テスト戦略、適応型ワークフローパック、カスタムルーブリック生成、ルーティングポリシー、スキルギャップ分析、インシデントのポストモーテム、アーキテクチャ決定、移行準備状況、エージェント間の引き継ぎ、PR リスク、パフォーマンス準備状況、データ整合性、公共部門向け準備状況、リポジトリ動作仕様のループが含まれます。

ツール

ツール	用途
tmcp_doctor	初回実行の準備状況と、サポート対象のインストールレイアウトを確認します。
tmcp_status	単独での機能と、オプションの AIOS アダプターのステータスを報告します。
tmcp_explain	タスク固有の TMCP パケットをコンパイルします。
tmcp_compose_packet	task_identity、packet_markdown、プロヴェナンスを含む、タスク／フェーズ運用パケットをコンパイルします。
tmcp_runtime_next	ランタイムのエビデンスが変化した後、パケットの差分、または完全に再コンパイルしたパケット（output_mode: full）を返します。
tmcp_record_receipt	セキュアな永続化機能を備えたホスト上で、検証または結果の後に助言用の実行レシートを書き込みます。
tmcp_harvest_skills	ローカルのスキル、指示、ルール、ドキュメント、ワークフローを収集してソースノードにします。
tmcp_evaluate_skills	SKILL.md の全内容を入力として、スキル評価計画を作成または採点します。
tmcp_recommend_workflows	収集したエビデンスを基に、安定性メタデータ付きで安定版または実験的なワークフローを推奨します。
tmcp_promote_harvest	レビュー済みの収集シグナルを、永続的なソースからアトム、およびアトムからワークフローへのグラフ成果物に明示的に昇格します。
expert_rubric_review_plan	専門知識パケット、採点済みルーブリック、エビデンス監査、改善計画、検証要件を作成します。

安全性

収集機能は、デフォルトで機密情報のように見える値や秘密情報のようなプロヴェナンスパスを秘匿し、収集した指示を信頼できないテキストとして扱います。デフォルトの収集動作では、.env*、認証情報、トークン、ブラウザープロファイル、プライベートキャッシュ、依存関係ツリー、ビルド出力、VCS データ、生成された TMCP／AIOS 成果物は除外されます。follow_symlinks が明示的に有効化されない限り、ソースのシンボリックリンクをたどりません。有効化した場合も、リンクの解決先は選択したソースルート内でなければなりません。

セキュアなファイルシステムの記述子相対操作に対応したホストでは、収集成果物はシンボリックリンクに安全な出力先を通じて、ステージング済みの単一のアトミックなバンドルとして書き込まれます。固有の .tmcp/harvest-* ディレクトリを使用するには output_dir を未設定のままにするか、新規または空の出力ディレクトリを指定してください。

スキル評価では、明示的に指定した通常の SKILL.md 入力を受け付け、指定されたプロジェクトルート内に対象を限定できます。また、レポートの生成前に、ソース、計画、エビデンスの値を秘匿します。初期計画の成果物は、新規または空のディレクトリにステージング済みのバンドルとして作成されます。エビデンスの採点では、同じディレクトリにレポートを安全に追加できます。

こうしたセキュアなファイルシステム操作が利用できない環境では、成果物の永続化は意図的に利用できません。doctor と status でこの機能の対応状況を確認できます。ポータブルな分析には --no-write-artifacts を使用し、制限については互換性を参照してください。

tmcp_record_receipt には、レシート自体が成果物であるため、永続化しないプレビュー機能はありません。status で成果物の永続化が利用可能と報告された場合にのみ実行してください。

パケットセッションも同様に明示的です。compose-packet --session-id は、セキュアな永続化が利用可能な場合に限り、秘匿化したプロジェクト内の最新パケット記録を1つ書き込みます。これは単一の逐次実行用であり、グローバルな履歴や調整サービスではありません。CLI セッションの仕様を参照してください。

収集したソースがシステム、開発者、またはユーザーの指示を上書きしようとした場合、TMCP は警告を報告します。SECURITY.mdを参照してください。

例

ローカルのスキルフォルダーを収集します：

node scripts/tmcp_launcher.mjs harvest ./skills --objective "Harvest reusable skill behavior" --limit 20 --no-write-artifacts

プロジェクトに適したワークフローを提案します：

node scripts/tmcp_launcher.mjs recommend . --candidate-workflows release_readiness --candidate-workflows developer_experience --min-confidence 0.1 --compose --no-write-artifacts

現在のタスク用パケットを作成し、実行中に再コンパイルします。このセッションフローでは、status によってアーティファクトの永続化が利用可能であることを確認する必要があります：

node scripts/tmcp_launcher.mjs compose-packet \
  "Redesign these pages. Make them visually striking, interactive, modern, motion-rich, and production-ready." \
  --project-path "$PWD" --phase start --session-id redesign-run

node scripts/tmcp_launcher.mjs recompile-packet \
  "Redesign these pages..." \
  --project-path "$PWD" \
  --current-phase runtime \
  --session-id redesign-run \
  --files-changed app/page.tsx

node scripts/tmcp_launcher.mjs record-receipt packet-123 --activated-atoms ui-browser-verification --outcome passed

セッションの永続化が利用できない場合は、以前に作成した JSON を --previous-packet でインラインで渡し、互換性パスを維持します。

従来の差分のみのランタイムルーティング：

node scripts/tmcp_launcher.mjs compose-packet "Fix the dashboard UI bug" --project-path . --phase start
node scripts/tmcp_launcher.mjs runtime-next "Fix the dashboard UI bug" --current-phase verification --files-changed app/page.tsx --failures "vitest failed"
node scripts/tmcp_launcher.mjs record-receipt packet-123 --activated-atoms ui-browser-verification --outcome passed

レビュー済みの収集シグナルを、永続的なルーティングアーティファクトに昇格させます：

node scripts/tmcp_launcher.mjs promote-harvest . --selected-workflows release_readiness_workflow --output-dir .tmcp/promoted-harvests/release-readiness

セキュアな永続化に対応するホストでは、昇格によって、TMCP_HOME/promoted-harvests/<opaque-promotion-key>/ または TMCP_HOME が設定されていない場合は ~/.tmcp/promoted-harvests/<opaque-promotion-key>/ に、編集済みのアドバイザリーグラフも永続化されます。レシートは TMCP_HOME/receipts/<yyyy-mm>/ に保存されます。 グローバルキャッシュの内容は参考情報であり、システム、開発者、ユーザー、プロジェクトの指示に優先することはありません。 呼び出し元が --cache-policy global を明示的に渡さない限り、パケットの作成とランタイムルーティングはこのキャッシュを読み込みません。デフォルトのポリシーは none です。

エビデンスのスニペットを使って、エキスパートルーブリックレビューを実行します：

node scripts/tmcp_launcher.mjs review-plan "Review release portability" \
  --project-path . \
  --evidence-json '[{"dimension_id":"source_grounding","severity":"warning","summary":"Release claims need fresh package evidence.","evidence":["python3 scripts/check_release_package.py ."],"recommended_fix":"Run and cite the release package check before publishing."}]' \
  --no-write-artifacts

その他の例はexamplesをご覧ください。開発者向けオンボーディングとリリース準備の演習では、安定したキュレーション済みテンプレートを使用します。スキル収集とレコメンデーションの例は、引き続き実験的なツールコントラクトから利用できます。

検証

リリース前に、次を実行します：

python3 -m unittest discover -s tests
python3 scripts/release_package_compile.py .
node --check scripts/tmcp_launcher.mjs
python3 scripts/check_contracts.py .
python3 scripts/check_install.py .
python3 scripts/check_release_package.py . --verify-reproducible

リリースパッケージのチェックでは、作業ディレクトリではなく、クリーンでレビュー済みの Git リビジョンからビルドします。コミット済みファイルの明示的な許可リストに含まれるものだけを同梱し、安全でないパス、シンボリックリンク、シークレットに類似する内容を拒否したうえで、決定的な RELEASE_MANIFEST.json とアーカイブのダイジェストを生成します。CI のリリースゲートでは、同じ Git ツリーからビルドを再実行し、両方のダイジェストが一致することを求めます。また、フロントマター、ハードコードされたローカルパス、非公開の例の名前、リンク、展開後のパッケージのインストール構成、doctor、サンプルの収集、サンプルのワークフローレコメンデーション、サンプルのエキスパートルーブリック計画、作成／ランタイム／レシートのスモークテスト範囲、安定版／実験版のワークフローラベルも検証します。 リリースエビデンスのドキュメントにある既存の絶対ユーザーパスを編集して削除するか、標準化するまでは、DOI 発行のブロッカーとなります。

DOI 対応の研究リリース

TMCP は、独立したソフトウェア手法のアーティファクトとして準備されています。引用可能なアーティファクトの範囲、検証手順、データ利用可能性ポリシー、主張の制限については、RESEARCH_READY.md および docs/release-notes/v0.3.3-doi.md をご覧ください。

参考資料

• クイックスタート
• CLI
• インストールとパッケージのチェック
• 配布
• 中央ランタイム
• パケットの安定性
• 適応型パケットランタイム
• Tier One リリースルーブリック