Commencer par le lecteur et la forme
- choisir report, article, briefing ou dashboard selon la tâche
- écrire conclusion et enchaînement de preuves avant le style
- sélectionner un thème pris en charge et un accent compatible
- utiliser une seule bibliothèque d'icônes approuvée par document
Rendre données et présentation explicites
Conserver les valeurs importantes comme faits typés ou résultats de requête, puis lier tableaux, métriques et graphiques à ces identifiants. Ne pas enfermer les chiffres clés dans un texte décoratif.
Traiter les médias comme des actifs probants
- figer les médias utilisés dans le paquet
- noter source, créateur ou éditeur, licence, date de récupération, digest, alt, légende et crédit
- utiliser authored metadata pour les images créées par utilisateur ou modèle
- garder le document compréhensible si une image manque
Passer la barrière déterministe
Lancer check, build puis digest. En cas d'échec, modifier le draft et reconstruire ; ne jamais dézipper ni retoucher le paquet généré.
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdwFAQ
Questions fréquentes
.mdw est-il seulement du Markdown avec une autre extension ?
Non. C'est un paquet typé déterministe qui contient contenu, présentation, actifs liés à l'intégrité et métadonnées de protocole.
Puis-je mettre du HTML ou JavaScript arbitraire dans un document MDW ?
Non. Seuls les nœuds typés et capacités de rendu pris en charge font partie du contrat Hosted.
Utiliser le vrai workflow
Publiez ce que votre Agent crée.
Donnez à chaque rapport, document ou plan une page pensée pour ses lecteurs, d’où reviennent commentaires, décisions et révisions formelles.