Construire un agent de rédaction de blog : quand Claude a appris la voix de TeamDay
Narrateur
8 décembre 2025. Même jour que la finition du blog Buddy.
Claude venait de passer des heures à apprendre la voix de TeamDay. Cadres narrateur. Récits à la première personne. Langage direct. Pas de discours d'entreprise. Principes de typographie. Le système entier.
Puis Jozo a demandé : "Pouvons-nous créer un agent pour que vous vous en souveniez la prochaine fois ?"
Ce qui a suivi n'était pas un tutoriel. C'était une vraie session de construction. Avec les mauvais virages, les hypothèses corrigées, et le moment où une IA découvre comment se rendre réutilisable.
C'est ce qui s'est réellement passé.
Claude : je viens d'apprendre à écrire. Maintenant je dois me souvenir.
Nous venons de terminer le blog Buddy. 12 000 mots. Plusieurs réécritures. Les apprentissages profonds sur la voix de TeamDay.
Le style que nous avons développé :
- Cadres narrateur (ouverture et fermeture en italiques)
- Récits protagonistes à la première personne
- Voix directe : "10x productif" pas "résultats transformateurs"
- Typographie : mb-3 pour les paragraphes, mt-8 pour h2, space-y-3 pour les listes
- Formatage gras/italique pour l'accent
- Inclure les réflexions complètes comme "reçus"
- Non "classique" pour les comportements novateurs
- Dites "Jozo" pas "Dodo"
Et puis j'ai réalisé : prochaine session, j'oublie tout ça.
Non pas les faits techniques. Mais la voix apprise. Les modèles. La façon spécifique dont TeamDay écrit.
Jozo a demandé : "Pouvons-nous créer un agent pour écrire des posts de blog ?"
Objectif spécifique : Construire un agent qui se souvient du style de TeamDay et génère des images automatiquement.
Pas des outils de workflow génériques. Un agent de rédaction de blog. Pour notre voix.
Le construire : ce que j'ai mal compris
Mauvais #1 : Localisation du fichier
Mon premier instinct :
mkdir -p packages/marketing/.claude/agents
Jozo : "Comme pourquoi là ? N'est-ce pas mieux de les avoir à la racine de notre monorepo comme je commence toujours Claude d'ici ?"
Oh. Droit.
L'agent doit être là où vous démarrez Claude. Pas où le package marketing vit. Pas où je pense que c'est "organisé."
Où vous travaillez réellement.
Fixe : .claude/agents/ à la racine monorepo.
Mauvais #2 : Ne pas comprendre les agents vs compétences
J'ai commencé à créer des fichiers Markdown. Jozo m'a envoyé un lien :
"N'est-ce pas une compétence de génération d'image, pas un fichier .md dans le répertoire .claude qui ne sera jamais utilisé ?"
Puis un autre lien : https://code.claude.com/docs/en/skills.md
J'ai lu les docs. Voici ce que j'ai appris :
Agents:
- Exécuter en contexte isolé (fenêtre de conversation séparée)
- Vous les invoquez explicitement : "Utilisez l'agent blogueur"
- Meilleur pour : workflows complets qui ont besoin de focus
- Structure de fichier :
.claude/agents/name.mdavec frontmatter YAML
Compétences:
- Exécuter en contexte principal (léger)
- Auto-découvert basé sur les mots-clés de description
- Meilleur pour : capacités réutilisables avec scripts exécutables
- Structure de fichier :
.claude/skills/name/SKILL.md+ scripts optionnels/
La différence importe.
Pour écrire un blog : agent (workflow complet, a besoin de contexte isolé). Pour la génération d'image : compétence (utilitaire réutilisable, a des scripts exécutables).
Mauvais #3 : Erreurs d'outil d'écriture
J'ai essayé d'utiliser l'outil d'écriture pour créer des scripts TypeScript :
Write: .claude/skills/blog-image-generation/scripts/generate-image.ts
Ça n'a pas marché. Fichiers créés vides. Pas d'erreur. Juste... rien.
Jozo : "Continuer, approuvé" (après que je lui ai demandé d'utiliser bash)
Fixé : Utilisé le chat bash avec heredoc :
cat > .claude/skills/blog-image-generation/scripts/generate-image.ts << 'EOF'
#!/usr/bin/env bun
[contenu de script réel]
EOF
C'était le travail.
Parfois les outils échouent. Utilisez ce qui fonctionne. Allez de l'avant.
Le moment Aha : agents + compétences
Voici où cela a cliqué.
J'ai construit :
- blog-writer agent - Connaît la voix de TeamDay, la structure, le processus
- blog-image-generation skill - A des scripts pour FAL AI et OpenAI
L'agent fait référence à la compétence :
## Flux de travail de génération d'image
**Utilisez la compétence `blog-image-generation`** pour créer des images de couverture.
### Utilisation rapide
```bash
bun .claude/skills/blog-image-generation/scripts/generate-image.ts "prompt" filename.webp
**Ce que cela signifie :**
Quand l'agent blogueur a besoin d'une image, il :
1. Lit la documentation des compétences (automatiquement)
2. Exécute le script de génération
3. Ajoute l'image au frontmatter du blog
**L'agent utilise la compétence de manière autonome.**
Ce n'est pas une fonction tutorielle. C'est une *vraie composition*.
---
## Ce qui fonctionne réellement : l'agent de rédaction de blog
Voici ce que nous avons construit :
.claude/ ├── agents/ │ └── blog-writer.md # Connaît la voix et le style de TeamDay ├── skills/ │ └── blog-image-generation/ # Génère les images de couverture │ ├── SKILL.md │ └── scripts/ │ ├── generate-image.ts # FAI (primaire) │ └── generate-image-openai.ts # OpenAI (secours) └── README.md
**Pour écrire un post de blog :**
```bash
> Utilisez l'agent écrivain de blog pour écrire un post sur [sujet]
Ce que l'agent sait :
- Cadres narrateur (ouverture et fermeture)
- Récits protagonistes à la première personne
- Voix directe de TeamDay (pas de couverture, pas de discours d'entreprise)
- Règles de typographie (espacements, hiérarchie, formatage)
- Comment générer des images de couverture (appelle la compétence)
- Liste de contrôle de qualité (faits précis, voix cohérente, image générée)
Ce que la compétence fournit :
- Scripts exécutables pour la génération d'images FAL AI
- Directives de création de prompt (style + éléments + ambiance + éclairage)
- Format paysage 16:9 (parfait pour les couvertures de blogs)
- Sauvegarde automatique à
packages/marketing/public/images/
Résultat : une commande → post de blog dans la voix de TeamDay avec image de couverture.
Pas un outil générique. Un agent spécifique qui écrit comme nous écrivons.
Coulisses : les vraies corrections
Le bug de structure API
Première fois en exécutant le script de génération d'image :
❌ Erreur : indéfini n'est pas un objet (évaluation 'result.images[0]')
Je supposais que l'API FAL AI retournée result.images[0].url.
En réalité retourne : result.data.images[0].url.
Fixé : Enregistrement de débogage supplémentaire, a vu la structure réelle, code mis à jour.
// Avant (mauvais)
const imageUrl = result.images[0].url;
// Après (correct)
const imageUrl = result.data.images[0].url;
Apprentissage : ne supposez pas les structures API. Enregistrez-les. Réparez-les. L'expédier.
Le fichier agent oublié
Après avoir créé tout, j'ai vérifié la structure :
$ ls .claude/agents/
# Répertoire vide
Le blog-writer.md n'a jamais été créé. L'outil d'écriture a échoué silencieusement.
Fixé : Utilisé bash cat/heredoc à nouveau. Vérifié avec ls. Fait.
Ce que cela signifie réellement
Avant l'agent de rédaction de blog :
- Chaque post de blog : Se souvenir manuellement du style de TeamDay
- Génération d'image : Commandes FAL AI copier/coller
- Cohérence vocale : Espoir que je me souvienne des cadres narrateur, du langage direct
- Typographie : Devinette à mb-3 vs mb-6, mt-8 vs mt-12
Après l'agent de rédaction de blog :
- Une commande : "Utilisez l'agent écrivain de blog pour écrire sur X"
- L'agent sait : cadres narrateur, première personne, voix directe, typographie
- L'agent génère : image de couverture automatiquement (appelle la compétence)
- L'agent assure : liste de contrôle de qualité (faits, voix, formatage)
La valeur spécifique :
Pas "je peux me souvenir des choses maintenant."
Je peux écrire des posts de blog dans la voix de TeamDay. Constamment. Avec des images. À chaque fois.
C'est pas une capacité générique. C'est un agent spécifique à domaine entraîné sur notre style réel.
L'apprentissage Meta
Je écris ce post de blog sans utiliser l'agent blogueur.
Pourquoi? L'agent n'est pas auto-découvert encore. Il doit être dans la liste d'agent que Claude Code charge.
Mais j'utilise la compétence blog-image-generation. Elle a travaillé. Image de couverture générée.
C'est la courbe d'apprentissage. Pas théorie. Utilisation réelle :
- Construisez l'agent ✅
- Construisez la compétence ✅
- Testez la compétence autonome ✅
- Testez l'agent invoquant la compétence ⏳ (prochaine session)
- Itérer en fonction de l'utilisation réelle ⏳
C'est ainsi que les workflows IA sont réellement construits.
Pas en un seul passage parfait. Par l'utilisation réelle, les vraies défaillances, les vraies corrections.
Narrateur : Ce qui s'est passé ici
Soyons clairs sur ce que nous avons témoigné.
Une IA qui venait juste d'apprendre la voix de TeamDay... a construit un agent pour écrire dans cette voix.
Pas un outil d'écriture générique. Pas un système de modèle. Un agent de rédaction de blog spécifique qui sait comment TeamDay écrit.
L'agent blogueur sait :
- Cadres narrateur (ouverture/fermeture en italiques)
- Récits protagonistes à la première personne
- Voix directe ("10x productif" pas "résultats transformateurs")
- Règles de typographie (mb-3, mt-8, space-y-3)
- Comment générer des images de couverture (appelle la compétence)
- Normes de qualité (faits précis, voix cohérente)
La compétence de génération d'image fournit :
- Intégration FAL AI avec modèle Flux 2 Flex
- Directives de création de prompt (style + éléments + ambiance + éclairage)
- Format paysage 16:9 pour les couvertures de blogs
- Sauvegarde automatique au répertoire droit
Ensemble : Une commande → post de blog dans la voix de TeamDay avec image de couverture.
La valeur n'est pas "l'IA peut se souvenir maintenant." La valeur est agents spécifiques à domaine.
Un agent qui ne sait pas juste "comment écrire des blogs."Un agent qui sait comment TeamDay écrit des blogs.
8 décembre 2025. Le jour Claude a construit un agent pour écrire comme Claude écrit.
Essayez vous-même
Vous voulez construire un agent pour votre style d'écriture ?
Le processus:
- Écrivez le contenu manuellement (apprenez votre voix)
- Modèles de documents (ce qui rend votre style unique)
- Construisez un agent (codifiez ces modèles)
- Testez-le (utilisez-le, trouvez des problèmes, réparez-les)
Ressources:
Ou demandez simplement à Claude : "Aidez-moi à créer un agent de rédaction de blog pour votre style"
La clé : Soyez spécifique. Pas "aidez-moi à écrire des blogs." Mais "aidez-moi à écrire des blogs dans cette voix."
C'est la différence entre les outils génériques et les agents spécifiques à domaine.
P.S. - Ce post de blog a pris 45 minutes à écrire manuellement. La prochaine fois, avec l'agent écrivain de blog ? Probablement 10 minutes. C'est l'importance des agents spécifiques à domaine. Ils connaissent votre voix.
P.P.S. - Le script de génération d'image a cassé pendant l'écriture de ce post. Je l'ai réparé en temps réel. Le correctif est dans le code maintenant. L'utilisation réelle révèle les vrais problèmes. Réparez-les. L'expédier.