Rédiger avec l'agent

Le dépôt contient un agent Claude Code, redacteur-doc, qui connaît la structure du site et les règles d'écriture. Tu lui donnes tes notes en vrac, il écrit la page au bon endroit et vérifie que le site compile.

Prérequis

• Le projet installé en local (voir Écrire la documentation).
• Claude Code installé et connecté.

Utilisation

1. Ouvre Claude Code à la racine du dépôt documentation.
2. Demande-lui d'utiliser l'agent, avec tes notes :

Utilise l'agent redacteur-doc : écris un tuto IT pour se connecter au wifi de l'atelier.
Notes : réseau "FETS-Atelier", mot de passe dans Vaultwarden (collection Général > Wifi atelier),
ne marche pas avec les vieux téléphones Android.

3. Relis la page générée avec npm run start. L'agent ne complète pas ce qu'il ne sait pas : il laisse des blocs À compléter que tu dois remplir.
4. Commit, push et ouvre une merge request comme pour n'importe quelle page.

Bonnes idées de demandes

• « Remplis l'onboarding Powertrain avec ces notes : … »
• « Transforme ce message Discord / ce courriel en tuto IT : … »
• « Relis docs/tutos-it/vaultwarden.mdx et signale ce qui n'est pas clair pour un nouveau. »

attention

Ne colle jamais de mot de passe ou de secret dans ta demande : indique seulement où le trouver dans Vaultwarden.

Modifier l'agent

Le comportement de l'agent est défini dans .claude/agents/redacteur-doc.md. Si les règles d'écriture changent sur la page Écrire la documentation, mets aussi l'agent à jour.