qmd から公開までのビルドワークフロー

qmd から公開までのビルドワークフロー A workflow diagram generated by Archify. 01 / 執筆 02 / ビルド + 検査 + 公開 03 / 利用側 執筆 ビルド + 検査 公開 + 配布 .qmd を書く · 1 概念 1 ファイル · 執筆 › 執筆 .qmd を書く 1 概念 1 ファイル quarto render · 拡張 + lua filter · ビルド + 検査 + 公開 › ビルド + 検査 · 単一ソース quarto render 拡張 + lua filter 単一ソース okf/ バンドル · stamp-okf.mjs · ビルド + 検査 + 公開 › ビルド + 検査 · post-render okf/ バンドル stamp-okf.mjs post-render validate-okf · 準拠 + 鮮度の警告 · ビルド + 検査 + 公開 › ビルド + 検査 · CI でも実行 validate-okf 準拠 + 鮮度の警告 CI でも実行 デプロイ · GitHub / Cloudflare Pages · ビルド + 検査 + 公開 › 公開 + 配布 デプロイ GitHub / Cloudflare Pages エージェント / RAG · frontmatter を先に読む · 利用側 › ビルド + 検査 エージェント / RAG frontmatter を先に読む 人間の読者 · _site/ の HTML · 利用側 › 公開 + 配布 人間の読者 _site/ の HTML 準拠 OK frontmatter で採用判断 エラー / 警告は修正 公開ページ post-render フック バンドルを検査 qmd を保存 Legend User UI Agent logic Policy Context / trace Cloud service External system

1 ソース・2 系統

  • • qmd を書けば HTML と okf/ バンドルが同じソースから出る
  • • post-render の stamp-okf.mjs が okf/ を更新する
  • • 人間もエージェントも同じソースを読む

緑になるまで止める

  • • validate-okf が準拠・鮮度・内部リンクを検査する
  • • 準拠エラーは失敗、鮮度切れは修正対象の警告
  • • CI でも同じスクリプトを回せる

frontmatter が信頼信号

  • • sources / generated / verified / stale_after / status
  • • 計算の正規性は Attested Computation 型が担う
  • • エージェントは本文より先に frontmatter を見る