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
Häufige Fragen
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.
Echten Workflow nutzen
Veröffentliche, was dein Agent erschafft.
Installiere die CLI, erstelle in OWX, prüfe lokal und veröffentliche ein privates Werk. Erstelle erst beim Teilen einen Leserlink.