ベストプラクティス · MDW authoring

Agent 向け MDW authoring のベストプラクティス

.mdw は renamed Markdown ではなく publication contract です。claims、structure、presentation、assets、evidence を検証可能にします。

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

reader と content shape

  1. reading task から canvas を選ぶ。
  2. conclusion / evidence を先に設計。
  3. supported theme / accent。
  4. one approved icon library。

data と presentation を明示

material values を typed facts / query results に置き、table / metric / chart から参照します。

media を evidence asset として扱う

  1. package へ byte を固定。
  2. source、license、date、digest、alt、caption、credit。
  3. generated image は authored metadata。
  4. image failure でも意味を保つ。

deterministic gate

check、build、digest を順に実行します。

ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw
製品境界

生成 archive を手編集せず、draft source を修正して再 build します。

よくある質問

よくある質問

.mdw は Markdown の別拡張子ですか?

違います。content、presentation、integrity assets、protocol metadata を含む typed package です。

任意 HTML / JavaScript を入れられますか?

入れられません。supported typed nodes を使います。

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

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

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