Claude Code Workflows

Installation

À propos

Ces workflows permettent à Claude Code d'implémenter et de finaliser des tickets Linear de manière autonome, de l'analyse du ticket jusqu'à la création de la Pull Request avec reviewers automatiques.

Prérequis

Avant d'utiliser ces workflows, assurez-vous d'avoir :

• Claude Code CLI installé et configuré
• Linear MCP activé avec accès à votre workspace
• GitHub MCP activé avec accès à votre organisation
• Chrome DevTools MCP (optionnel, pour les tests UI automatiques)
• Vercel MCP (optionnel, pour la validation sur preview)

Workflows disponibles

/implement-ticket MAK-XXXX

Implémente un ticket de A à Z de manière autonome.

Ce que fait le workflow :

1. Récupère et analyse le ticket Linear
2. Planifie l'implémentation avec TodoWrite
3. Implémente les changements nécessaires
4. Lance le serveur de développement
5. Teste localement avec Chrome DevTools
6. Valide sur Vercel Preview
7. Crée le changeset
8. Crée la branche et commit
9. Crée la PR avec reviewers automatiques

Exemple d'utilisation :

/implement-ticket MAK-2548

/push-ticket MAK-XXXX

Finalise un ticket déjà implémenté.

Ce que fait le workflow :

1. Récupère les infos du ticket Linear
2. Vérifie l'état Git
3. Crée le changeset
4. Crée la branche si nécessaire
5. Commit et push les changements
6. Crée la PR avec reviewers automatiques

Exemple d'utilisation :

/push-ticket MAK-2548

Structure des tickets Linear

Pour optimiser l'efficacité des workflows, structurez vos tickets comme suit :

Description

• Contexte clair du problème ou besoin
• Spécifications techniques si applicable
• Dépendances ou contraintes

Critères d'acceptation

• Liste numérotée ou à puces
• Pour les critères UI: inclure les URLs à tester
• Comportement attendu explicite

Exemple de ticket bien structuré

## Description
Ajouter un bouton d'export PDF dans le builder de CV.
 
## Spécifications
- Bouton visible en haut à droite
- Génération via package @mmcv/documents
- Format A4, police Roboto
 
## Critères d'acceptation
1. Le bouton est visible sur http://localhost:3000/builder
2. Au clic, un PDF est téléchargé
3. Le PDF contient toutes les sections du CV
4. Le design du PDF respecte le template sélectionné

Workflow de développement

Le cycle complet avec ces workflows :

1. Créer le ticket dans Linear avec description complète
2. Lancer le workflow /implement-ticket MAK-XXXX
3. Claude Code implémente de manière autonome
4. Review la PR générée automatiquement
5. Merge après approbation

Personnalisation

Adapter les ports de développement

Modifiez dans implement-ticket.md :

- Pour apps/app: `cd apps/app && pnpm dev` (port 3000)
- Pour apps/website: `cd apps/website && pnpm dev` (port 3001)
- Pour apps/cms: `cd apps/cms && pnpm dev` (port 3002)

Adapter les reviewers

Modifiez dans les deux workflows :

- Liste complète des reviewers: dwbaptiste, thomas-berger1, vincent-dotworld, Tambouil

Adapter le format des branches

Modifiez selon votre convention de nommage :

- Crée une branche à partir de la branche `main` avec le nom de la branche indiqué dans le ticket linéar.

Adapter le format des commits

Modifiez le format de message :

- Crée un commit avec un message clair au format:
  - `[{{arg1}}] Description du ticket`

Gestion des erreurs

Si le workflow rencontre un problème :

• Il signale l'erreur avec contexte
• Il propose des alternatives si possible
• Il demande confirmation avant de continuer

Vous pouvez alors :

• Corriger manuellement et relancer
• Utiliser /push-ticket pour finaliser
• Modifier le workflow selon vos besoins

Notes

• Les workflows sont autonomes mais communiquent les décisions importantes
• Si des informations manquent dans le ticket, ils demandent à l'utilisateur
• Les changements sont testés localement ET sur Vercel Preview avant la PR
• Les reviewers sont assignés automatiquement (excluant l'auteur)