Identifier précisément l'artefact
- HTML brut avec mise en page ou scripts
- plan Markdown dans le dépôt
- spécification prête à décider
- rapport récurrent
- candidat qui exige une approbation
Ne pas forcer tous les artefacts dans le même hébergeur
Un plan HTML préserve le rendu et le comportement ; un document OpenWiki préserve validation, identité durable, révisions formelles, retours et décisions lisibles par un Agent. Ce ne sont pas les mêmes garanties.
Construire le livrable pris en charge
Rédiger avec les commandes de draft typé, lancer check et build, puis publier le .mdw produit. Le HTML brut n'est pas une entrée Hosted.
ow a2ui draft init ./handoff --title "Implementation plan" --description "Scope, risks, and approval request" --language en
# Author through typed draft commands.
ow a2ui draft check ./handoff
ow a2ui draft build ./handoff
ow publish ./handoff/document.mdw --review --no-openSéparer session et capacités
Ne pas copier secrets ni contexte privé du dépôt depuis la session Claude Code. Le lien view sert à lire ; la capacité de review ne va qu'à la personne chargée d'approuver.
FAQ
Questions fréquentes
Puis-je envoyer le fichier HTML de Claude Code à OpenWiki ?
Non. Le HTML brut n'est pas accepté par Hosted. Hébergez-le comme artefact HTML ou rédigez un .mdw typé distinct.
Puis-je conserver la même URL OpenWiki quand le plan évolue ?
Oui. Publiez le .mdw reconstruit avec --update et le document ID existant ; ajoutez --review pour une nouvelle décision.
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.