Comment un développeur a utilisé Claude Code avec Linear et Discord pour une construction solo de 30 jours

Le Projet et la Stack

Un développeur a créé VGC Team Report (pokemonvgcteamreport.com), un constructeur d'analyses d'équipe pour le Pokémon compétitif (VGC) qui génère des rapports détaillés avec des plans de match-up, des calculs de dégâts, des paliers de vitesse et des rapports partageables. Le projet a été construit en 30 jours de soirées et week-ends avec 274 commits, ~42 000 lignes de TypeScript, 25 fonctionnalités livrées via Linear, 66 composants React, 41 routes API et 22 hooks personnalisés. La stack comprenait Next.js 16 (App Router), React 19, TypeScript (mode strict), Tailwind CSS v4, Clerk pour l'authentification, Neon pour Postgres serverless, et Vercel pour l'hébergement et les déploiements.

Le Flux de Travail : Linear → Claude → Discord → Vercel

Le développeur a intégré Claude Code dans Linear pour le suivi des tickets et Discord pour les notifications de compilation afin de créer un pipeline de développement automatisé. Une session typique suivait cette séquence :

1. Claude exécute linear_get_in_progress pour vérifier le tableau Linear pour les tickets
2. Sélectionne le ticket de priorité la plus élevée (les bugs d'abord)
3. Lit les fichiers pertinents et implémente la fonctionnalité ou la correction
4. Exécute tsc --noEmit && npm run build — si cela échoue, Claude corrige les erreurs
5. Commit avec le format d'ID de ticket : VGC-42 : Ajouter un graphique des paliers de vitesse
6. Pousse sur main
7. Poste un commentaire sur le ticket Linear via GraphQL avec l'URL du commit et les fichiers modifiés
8. Déplace le ticket vers En Revue
9. Appelle discord_notify_build — poste un embed dans Discord #builds avec le commit, la liste des fichiers modifiés et l'état du déploiement
10. Vercel déploie automatiquement depuis main
11. Passe au ticket suivant

Cela a été implémenté via un script bash linear.sh avec des fonctions que Claude appelle directement : linear_get_in_progress (interroge Linear GraphQL pour les tickets En Cours), linear_move_issue (déplace un ticket vers un nouvel état), linear_comment_with_changes (poste un commentaire avec le lien du commit et les fichiers modifiés), et discord_notify_build (envoie un embed Discord avec les infos du commit et l'état du déploiement).

Le Manuel d'Utilisation CLAUDE.md

Un fichier CLAUDE.md à la racine du dépôt fournit le contexte pour chaque session Claude. Les sections clés incluent :

• Stratégie Git : Développement basé sur le tronc avec des poussées directes sur main pour le travail routinier, des branches de fonctionnalité uniquement pour les changements importants ou risqués, et npx tsc --noEmit && npm run build avant chaque poussée comme non-négociable
• Flux de travail Linear : IDs d'état exacts pour "En Cours" et "En Revue", comment interroger et implémenter les tickets, commit avec le préfixe VGC-XX, poster des commentaires de commit, déplacer les états des tickets, avec les tickets de bug toujours traités en premier
• Notifications Discord : Format de la fonction discord_notify_build avec différents embeds pour les poussées directes vers main vs les flux de PR
• Gestion des échecs : Échec de compilation → corriger et réessayer, ne jamais pousser du code cassé ; Échec de l'API Linear → quand même committer et pousser, noter l'échec à l'utilisateur ; Rupture en production → git revert, pousser sur main, notifier Discord, remettre le ticket en arrière
• Conventions de code : Suivre les modèles existants, pas de refactorisations opportunistes, messages de commit : VGC-XX : description pour le travail suivi

Surveillance Automatisée

Deux tâches cron Vercel ont été configurées : une vérification quotidienne à 9h pour la santé du site, le scan des tickets obsolètes, l'audit SEO et la santé de la base de données (poste des alertes sur Discord uniquement en cas de problème), et un résumé hebdomadaire le vendredi à 17h pour les progrès Linear, la croissance des utilisateurs et les mises à jour des dépendances (poste toujours un résumé sur Discord). La surveillance de la disponibilité en temps réel utilisait UptimeRobot avec des ping toutes les 5 minutes.

Ce qui a Fonctionné

Le développeur a souligné plusieurs pratiques efficaces : le développement basé sur le tronc avec des contrôles de typage (tsc --noEmit && npm run build) garantissant que chaque poussée sur main se déploie automatiquement sur Vercel avec une boucle de rétroaction de quelques minutes ; la traçabilité des tickets Linear avec chaque commit lié à un ticket et chaque ticket ayant un commentaire avec l'URL du commit et les fichiers modifiés ; Discord comme piste d'audit avec chaque compilation postée dans #builds ; et le fichier CLAUDE.md comme l'élément de projet le plus précieux pour maintenir un contexte cohérent entre les sessions.