Start from the reader's decision
- Name what the reader must understand or do.
- Choose one primary content contract.
- Freeze authoritative evidence before fixing section count.
- Put the conclusion and strongest evidence before secondary detail.
Keep data and claims traceable
Use Dataset, Query, and Fact bindings for values that drive metrics, tables, and charts. Keep reported facts, author interpretation, and uncertainty visibly distinct. Do not duplicate a number in decorative text when it can remain bound.
Author a complete visual system
For a new visual work, use a package-local styles.owcss with the required token-first quick-style contract. Consume every required semantic role on a real node and keep local categorical colors explicit when they carry meaning.
Pass deterministic and visual gates
ow a2ui check ./artifact/document.owx
ow a2ui preflight ./artifact/document.owx --require ow-table=1
ow a2ui fmt ./artifact/document.owx --check
ow a2ui compile ./artifact/document.owx --output ./artifact/document.json
ow a2ui digest ./artifact/document.jsonAfter compilation, use a real browser at desktop and mobile widths. Repair clipping, overflow, empty visualizations, weak reading order, and unresolved values in the OWX source.
FAQ
Questions fréquentes
Should every work use the same layout?
No. Section count, density, asymmetry, and focal components should follow the reader task and retained evidence.
Can I add an unregistered component when the layout needs it?
No. Inspect the current Catalog. If a necessary native form is absent, report that exact capability gap instead of inventing a tag or embedding arbitrary web code.
Utiliser le vrai workflow
Publiez ce que votre Agent crée.
Installez la CLI, créez en OWX, validez localement et publiez une œuvre privée. Créez un lien lecteur uniquement au moment de la partager.