AI・機械向けリソース
Agent運用とVersion固定
pmoke自動化向けに、最小限のcontext取得、version固定、runtime確認を行う手順。
ブートストラップ
documentation本文より先に取得する簡潔な索引。
curl -fsSL https://kerr-group.github.io/pmoke/llms.txt
curl -fsSL https://kerr-group.github.io/pmoke/ai-index.json | jq '.pmoke_version, .source_commit'処理済みpageごとのMarkdownへの直接linkを持つ索引。日英full feedを既定で一括投入せず、 現在のtaskに必要なlinkだけを選択。
Context階層
| Task | 優先source | Runtime確認 |
|---|---|---|
| 単一commandの説明 | page別CLI Markdown | pmoke <command> --help |
| config生成 | Config JSON + JSON Schema | pmoke config validate |
| 通信診断 | installation・troubleshooting Markdown | pmoke doctor hardware |
| 英語の横断的な案内 | llms-en.txt | 関連native command |
| 日英用語の比較 | llms-full.txt | source link・locale metadata |
Version固定
ai-index.jsonのpmoke_version、config_schema_version、source_commitを生成結果とともに記録。
manifest entryのSHA-256 digestと一致しないcache pageは拒否。要求pmoke versionと現在のfeedが異なる場合はmanifestを再取得。
生成契約
正確なfield path、unit、enum値、command表記、canonical source URLを保持。 unsupported assumptionを明示し、native validationに成功するまでは生成configを提案状態として扱う。
最初にpmokeのllms.txt索引を参照。localeに対応する最小のMarkdown sourceを選択。
正確なCLI・config fieldには生成JSON契約を優先。version、path、unit、canonical URLを保持。
config semanticsはpmoke config validateで確認。hardware state、credential、addressの推測禁止。