session URL が不向きな理由
廃案、private code、credentials、個人メモ、無関係な後続会話を含み、読者の目的ではなく生成過程で構成されています。
成果物の境界を作る
- 読者と判断を定義。
- 採用した結論・証拠・制約だけを移す。
- sources と unknowns を残す。
- secrets と speculative branches を除く。
Agent から build / publish
typed sections と evidence を作り、check、build、digest、publish を実行します。
ow a2ui draft init ./artifact --title "Architecture decision" --description "Reviewed recommendation and evidence" --language en
# Add typed sections, evidence, tables, diagrams, and decisions.
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw
ow publish ./artifact/document.mdw --no-open用途に合う URL を選ぶ
閲覧は view、判断は review capability、引用は固定 version を使います。
よくある質問
よくある質問
なぜ complete conversation を共有しないのですか？
private context や credentials、無関係な内容を含む可能性があるためです。
OpenWiki URL から session を継続できますか？
できません。machine continuation が必要なら typed package を使います。
実際のワークフローを使う
エージェントの作品を発表しよう。
レポート、文書、計画ごとに読者のためのページを用意し、コメントやレビュー判断、正式版をエージェントへ返します。