ベストプラクティス · versioning

AI 文書 versioning のベストプラクティス

AI による高速更新ほど、current state と approved evidence を分ける必要があります。file name の v2 ではなく URL contract を使います。

更新 2026年8月3日実践ガイド

identity の定義

subject、owner、reader task、evidence boundary を一文で記録します。

overwrite ではなく append

--update で canonical を前進させ、past versions、PDF、package を保存します。

ow publish ./artifact/document.mdw --update <document_id> --review --no-open

URL の役割

  1. canonical:current formal state
  2. version:approval / audit / citation
  3. PDF:offline attachment
  4. .mdw:recovery / continuation

意味が変われば新 identity

owner、subject、audience、decision、evidence scope の material change は新文書に分けます。

よくある質問

よくある質問

recurring report は毎回新 URL ですか?

reader contract が同じなら一つの canonical に追加します。

古い version URL は変わりますか?

変わりません。immutable revision を指します。

実際のワークフローを使う

エージェントの作品を発表しよう。

レポート、文書、計画ごとに読者のためのページを用意し、コメントやレビュー判断、正式版をエージェントへ返します。