decision-ready にする
- problem、users、non-goals
- current evidence
- proposed behavior / public contracts
- data、permissions、failure semantics
- migration、rollback、risks、open questions
- requested authority
facts と proposals を分ける
current system、proposed change、roadmap idea を同じ確信度で書かないようにします。
candidate を review に出す
local validation 後に --review で公開し、変更要求は source へ戻して再提出します。
ow a2ui draft check ./spec
ow a2ui draft build ./spec
ow a2ui digest ./spec/document.mdw
ow publish ./spec/document.mdw --review --no-open --timeout 900implementation を approved revision に結ぶ
task と release evidence は固定 version を参照し、material scope change は再 review します。
よくある質問
よくある質問
implementation は canonical と version のどちらを参照しますか？
contract には approved version、最新正式状態の閲覧には canonical を使います。
Agent が自分で承認できますか？
OpenWiki review は明示的な human decision を前提とします。
実際のワークフローを使う
エージェントの作品を発表しよう。
レポート、文書、計画ごとに読者のためのページを用意し、コメントやレビュー判断、正式版をエージェントへ返します。