PJR-T7EM ifx-cmd（外部コマンド連携仕様）の新設
1. 概要
esil.schema.yaml の interfaces[].kind が API／ファイル／メッセージの3値固定で、CLIコマンド起動型の外部連携（AI provider CLI、Git/GitHub等）を表す区分が無い。ifx-cmd-rulebook.md を新設し、esil.schema.yaml のkind・spec_refパターンを拡張する。
あわせて、レビューで発見した命名不整合を修正する。ifx-index（ESIL一覧）は他ドメインの -index Hub命名規約（opd-index→opd-index-rulebook等）に反し specdojo:ifx-rulebook を参照していた。ifx-rulebook.md を ifx-index-rulebook.md へリネームし、命名を統一した（本チケット登録前に実施済み。作業内容No.0参照）。
2. 完了条件
esil.schema.yamlのinterfaces[].kindenum に、CLIコマンド起動型の連携を表す区分としてコマンドが追加されていること（既存のAPI／ファイル／メッセージと並ぶ確定値。他の値へ変更しない）。esil.schema.yamlのinterfaces[].spec_refパターンがifx-cmd-...を許容していること。あわせて、現状eapis/efes/emsのままになっているspec_refパターンを、各rulebook本文が指示するifx-api/ifx-file/ifx-msg接頭辞と一致させること（新パターン例:^(?:ifx-api|ifx-file|ifx-msg|ifx-cmd)-[a-z0-9-]+$|^TBD$）。ifx-index-rulebook.mdのkind説明表に新区分（コマンド）が追記されていること。ifx-cmd-rulebook.md（コマンド名・引数・stdin/stdout・終了コード・認証注入方式・エラー処理を定義する構成）が新設されていること。markdown.instructions.mdに従いspecdojo:frontmatter（id: specdojo:ifx-cmd-rulebook、recipe: specdojo:ifx-cmd-recipe、sample: specdojo:ifx-cmd-sample、template: specdojo:ifx-cmd-template等）を持つこと（ifx-api-rulebook.md／ifx-file-rulebook.md／ifx-msg-rulebook.mdはfrontmatterを欠いているが、これは既存の別問題であり、新設するifx-cmd-rulebook.mdでは模倣しない。frontmatter以外の構成・記述方針はifx-api-rulebook.mdに準じる）。ifx-cmd-recipe.md／ifx-cmd-sample.yaml／ifx-cmd-template.yaml（それぞれdocs/ja/specdojo/recipes/／samples/／templates/）が新設されていること。ifx-api/ifx-file/ifx-msgの3件は現状「sample（YAML）のみ・recipe/templateなし」だが、kata（rulebook/recipe/sample/template）を広く整備する方針（PJR-1F46）に従い、ifx-cmdは4種すべてを揃える。既存3件への同様の拡張は本チケットのスコープに含めない（必要になった時点で別途判断する）。id-and-file-naming-standard.md14.2 にifx-cmd-prefix の行が追加されていること。deliverables-reference.md2.2 に「外部コマンド連携仕様」の行が追加されていること。prj-0001:dct-external-interface-specsのifx-indexにある暫定記述のうち、kind: APIをkind: コマンドへ更新すること。spec_ref: TBDは、実在するifx-cmd-<term>（例:ifx-cmd-claude／ifx-cmd-git）の詳細仕様ドキュメントが未作成のため、本チケットの完了条件には含めずTBDのまま据え置く（実在のifx-cmd-<term>詳細仕様の作成は別チケットのスコープとする）。npm run -s lint:mdにエラーがないこと。npm run docs:buildが成功すること。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 0 | ifx-rulebook.md を ifx-index-rulebook.md へリネーム（ifx-indexのHub命名規約への統一） | ARC | done | 対象: docs/ja/specdojo/rulebooks/ifx-rulebook.md→ifx-index-rulebook.md（frontmatter・英語名行を追加）。参照元5ファイル（dct-external-interface-specs.yaml／dct-external-interface-specs-template.yaml／deliverables-reference.md／docs/ja/sample-gcs-product/...／本チケット）を追従。孤立していた旧ifx-index-rulebook.md（Markdown Hub想定の未使用スタブ）とifx-index-sample.mdは破棄した |
| 1 | esil.schema.yaml の kind 区分追加（コマンド固定値）・spec_ref パターン修正（eapis/efes/ems→ifx-api/ifx-file/ifx-msg／ifx-cmd） | ARC | done | kind に コマンド を追加し、spec_ref を ifx-api / ifx-file / ifx-msg / ifx-cmd 接頭辞へ統一 |
| 2 | ifx-index-rulebook.md の kind 説明表更新 | ARC | done | kind と spec_ref の説明にコマンド連携を追加 |
| 3 | ifx-cmd-rulebook.md／ifx-cmd-recipe.md／ifx-cmd-sample.yaml／ifx-cmd-template.yaml（kata一式）の新設 | ARC | done | 起動契約、引数、ストリーム、終了コード、認証注入、エラー処理を定義する kata 4 種を新設 |
| 4 | id-and-file-naming-standard.md 14.2 の更新 | ARC | done | 外部コマンド連携仕様の ifx-cmd- prefix 行を追加 |
| 5 | deliverables-reference.md 2.2 の更新 | ARC | done | 外部コマンド連携仕様の目的、推奨ファイル名、主な内容を追加 |
| 6 | dct-external-interface-specs.yaml（ifx-index）のkind更新、lint:md／docs:build 実行 | ARC | done | 暫定の kind: API 記述を kind: コマンド に更新し、spec_ref: TBD 方針は維持。完了条件の検証を実施 |
4. 対応結果
- No.0（
ifx-rulebook.md→ifx-index-rulebook.mdリネーム）は、PJR-MWXSレビューの過程でopd-index／opr-index／sf-indexの同種命名不整合を確認した際に併せて発見し、本チケット登録と同時に実施済み。catalog validate／lint:mdで確認済み（詳細な検証コマンド結果は本チケット完了時にNo.1〜6分とまとめて記録する）。 - レビューで4点の曖昧さ（
kind新値の未確定、完了条件と作業内容No.6のスコープのズレ、recipe/sample/template方針の未確定、frontmatter要否の未確定）を指摘され、bootstrap approachへの委譲可否も検討した。bootstrapは成果物カタログ1件とそのkata一式のみを編集対象とし、esil.schema.yaml／id-and-file-naming-standard.md／deliverables-reference.mdのようなフレームワーク横断ファイルには触れられないこと、またifx-cmd-<term>のカタログエントリ自体がまだ存在せずbootstrapを紐づける対象が無いことから、deferせず本チケットのまま実行する方針とした。 - recipe/sample/template方針は、当初「先例（ifx-api/file/msg、sampleのみ）に揃える」としたが、今後bootstrap approachで多くの成果物のkata一式（rulebook/recipe/sample/template）を広く整備していく方針（PJR-1F46）に合わせ、
ifx-cmdも4種すべてを新設する方針へ修正した。既存3件（ifx-api/file/msg）への同様の拡張は本チケットのスコープに含めない。 - No.1～6 を実施し、ESIL の区分・参照規則、一覧 rulebook、命名標準、成果物リファレンス、成果物カタログの記述を
ifx-cmdに整合させた。 ifx-cmdの kata 4 種は YAML 成果物を対象とし、実行可能ファイルと引数の分離、stdin／stdout／stderr、終了カテゴリ、秘密値を含めない認証注入、タイムアウト・冪等性・再試行条件を共通構造で定義した。- 個別の
ifx-cmd-<term>成果物は未作成のため、prj-0001:dct-external-interface-specsのspec_ref: TBD方針は完了条件どおり維持した。 - 新規 kata の ID 4 件は
index buildで解決でき、ESIL schema、Prettier、Markdownlint、frontmatter、catalog build / validate、register build、YAML page build、関連 40 テストは成功した。 npm testのうち Git リポジトリを作成する 33 テストは実行環境がspawnSync gitをEPERMで拒否した。npm run docs:buildはtsxの IPC ソケット作成、手動分解した VitePress build は Mermaid 用 Chromium の起動を同じくEPERMで拒否された。いずれもタスク差分の解析前に失敗する sandbox 制約である。- 上記は「2. 完了条件」「3. 作業内容」へ反映済み。
5. 関連ドキュメント
- prj-0001:dct-external-interface-specs:
ifx-indexの暫定記述（kind: API／spec_ref: TBD）が更新対象 - specdojo:ifx-index-rulebook:
kind区分を追記する対象（ifx-rulebookからリネーム済み） - specdojo:ifx-api-rulebook:
ifx-cmd-rulebook.mdが構成・記述方針で準じる直接の先例（frontmatterは模倣しない） - specdojo:id-and-file-naming-standard:
ifx-cmd-prefixを追加する対象 - specdojo:deliverables-reference: 「外部コマンド連携仕様」を追加する対象
- specdojo:kata-guide: rulebook / recipe / sample / template の役割分担
- specdojo:ryu-guide: bootstrap approachの適用範囲（本チケットをdeferしない根拠）
- prj-0001:pjr-mwxs-uis-index-rulebook-bds-index-rulebook: 同種の
-index命名不整合を発見した経緯