Why a session link is the wrong handoff for many tasks
A session can contain abandoned ideas, proprietary code, credentials, personal notes, and later messages unrelated to the result. It is also organized around how the answer was produced rather than what the recipient needs to decide or use.
Create a work product boundary
- Name the recipient and the decision or task the document must support.
- Move only supported conclusions, evidence, constraints, and next actions into the document.
- Keep source references and state what remains unknown.
- Remove conversation-only context, secrets, and speculative branches.
Build and publish from the Agent
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-openChoose the right link
Use a view link for reading, a review capability only when the recipient must decide on a candidate, and a fixed version permalink when the handoff must keep identifying the exact approved revision.
FAQ
Frequently asked questions
Why not share the complete Agent conversation?
A session can contain abandoned ideas, private context, credentials, and unrelated messages. A separate artifact exposes only the reviewed work product.
Can the recipient continue the Agent session from an OpenWiki link?
No. The publication is the governed output, not a transferable session. Another Agent can inspect the typed package when machine-readable continuation is needed.
Use the real workflow
Publish what your agent creates.
Give every report, document, or plan its own reader-ready page. Comments, review decisions, and formal revisions can flow back from there.