claude-code-veille

name	claude-code-veille
description	Veille, reference et migration Claude Code. 3 modes : veille, reference, migration. Utiliser quand l'utilisateur demande les nouveautes Claude Code, veut documenter une fonctionnalite ou prepare une mise a jour. Pas pour /help ou /doctor.
allowed-tools	Bash, Read, Write, Glob, Grep, WebFetch
argument-hint	[veille|reference <sujet>|migration] [--output fichier.md]
context	conversation

Skill : /claude-code-veille

Veille technologique, documentation de référence et migration pour Claude Code. Analyse le changelog officiel, compare avec la version installée et le workflow en place.

---

Déclencheurs

• /claude-code-veille → mode veille (défaut)
• /claude-code-veille reference <sujet> → documentation d'une fonctionnalité
• /claude-code-veille migration → détection des breaking changes
• "Quoi de neuf dans Claude Code ?"
• "Documente la fonctionnalité X de Claude Code"
• "Est-ce que ma config est compatible avec la dernière version ?"

---

Mode 1 : veille (défaut)

Analyse les nouveautés de Claude Code et filtre ce qui est pertinent pour le workflow.

Workflow

Étape 1 : collecte

1. Récupérer la version installée :

   claude --version
   

2. Fetcher le changelog depuis GitHub :

   gh api repos/anthropics/claude-code/contents/CHANGELOG.md --jq '.content' | base64 -d
   

3. Si gh échoue, utiliser WebFetch sur https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md

Étape 2 : analyse

1. Extraire les versions plus récentes que la version installée
2. Classer chaque changement par pertinence pour le workflow :

Voir references/categories-pertinence.md pour la grille complète de filtrage par catégorie.

Étape 3 : rapport

Écrire le rapport dans veille/veille-claude-code-YYYY-MM-DD.md :

# Veille Claude Code — YYYY-MM-DD

**Version installée** : X.Y.Z
**Dernière version** : X.Y.Z
**Statut** : à jour | X versions de retard

## Nouveautés pertinentes pour ton workflow

### [fonctionnalité]
- **Ce que c'est** : description
- **Impact** : comment ça affecte ton workflow
- **Action recommandée** : ce qu'il faut faire (ou rien)

## Corrections de bugs qui te concernent

- [description] (version X.Y.Z)

## Autres changements (résumé)

- X corrections de bugs Windows/PowerShell (non pertinent)
- X améliorations internes

---

Mode 2 : référence

Documente une fonctionnalité spécifique de Claude Code.

Sujets disponibles

Voir references/sujets-disponibles.md pour la liste complète des sujets et fiches existantes.

Workflow

Étape 1 : identification

1. Extraire le sujet de $ARGUMENTS (mot après "reference")
2. Si pas de sujet, demander via la conversation

Étape 2 : recherche

1. Chercher dans fiches/ si une fiche existe déjà :

   Glob("fiches/*{sujet}*")
   

2. Si fiche trouvée : la lire et vérifier si elle est à jour par rapport au changelog
3. Si pas de fiche : chercher dans le changelog + code source fuité

Étape 3 : production

1. Si fiche existante et à jour : l'afficher et confirmer
2. Si fiche existante mais obsolète : proposer une mise à jour
3. Si pas de fiche : créer veille/reference-{sujet}.md avec cette structure :

# Référence : {sujet}

Description courte de la fonctionnalité.

## Ce que c'est

Explication du fonctionnement.

## Configuration

Comment activer/configurer (fichier, commande, variable).

## Usage courant

Exemples concrets d'utilisation dans le workflow.

## Limitations

Ce que ça ne fait pas, cas limites connus.

*Source : changelog vX.Y.Z, code source fuité*

---

Mode 3 : migration

Détecte les breaking changes et leur impact sur le workflow.

Workflow

Étape 1 : collecte

1. Version installée (claude --version)
2. Changelog GitHub (même méthode que mode veille)
3. Lire la configuration actuelle :

   Read .claude/settings.json          → hooks et permissions
   Bash grep CLAUDE_CODE ~/.zshrc      → variables d'environnement
   Read CLAUDE.md                      → conventions
   Glob .claude/rules/*.md             → règles actives
   

Étape 2 : détection

1. Extraire les lignes commençant par "Changed", "Removed", "Deprecated" depuis la dernière version
2. Pour chaque changement, vérifier l'impact :
   • Hook modifié ? → vérifier settings.json
   • Variable supprimée ? → vérifier ~/.zshrc
   • Commande renommée ? → vérifier CLAUDE.md et rules
   • Permission changée ? → vérifier settings.json
   • Comportement par défaut modifié ? → signaler

Étape 3 : rapport

Écrire dans veille/migration-YYYY-MM-DD.md :

# Migration Claude Code — YYYY-MM-DD

**De** : version X.Y.Z → **Vers** : version X.Y.Z

## Breaking changes

### [changement]
- **Ce qui change** : description
- **Impact sur ton workflow** : fichier ou config concerné
- **Action** : ce qu'il faut modifier

## Changements de comportement par défaut

### [changement]
- **Avant** : comportement précédent
- **Maintenant** : nouveau comportement
- **Action** : adapter ou ignorer

## Aucune action requise

- [liste des changements sans impact]

---

Règles

• TOUJOURS vérifier la version installée avant d'analyser le changelog
• TOUJOURS filtrer par pertinence — ne pas lister 50 corrections de bugs Windows
• TOUJOURS proposer des actions concrètes (pas juste "à surveiller")
• TOUJOURS écrire le rapport dans un fichier (pas dans le chat si > 30 lignes)
• JAMAIS inventer des fonctionnalités non présentes dans le changelog
• JAMAIS recommander une action sans vérifier l'impact sur la config existante

---

Gestion d'erreurs

Situation	Comportement
gh non disponible	Fallback WebFetch sur raw.githubusercontent.com
Changelog inaccessible	Message d'erreur, proposer de vérifier la connexion
Version non trouvée dans le changelog	Indiquer la version la plus proche
Sujet de référence inconnu	Lister les sujets disponibles
Aucun breaking change	Rapport positif ("aucune action requise")
Plus de 5 versions de retard	Résumer les changements par version, recommander une migration progressive, lancer /claude-code-veille migration en priorité
Changelog très long (> 1000 lignes)	Ne traiter que les versions depuis la version installée, ignorer l'historique antérieur
Aucun argument ($ARGUMENTS vide)	Mode veille par défaut
Répertoire de fiches introuvable (fiches/)	Chercher dans veille/ en fallback, signaler le répertoire manquant

---

Exemples d'utilisation

/claude-code-veille

Version installée : 2.1.89 Dernière version : 2.1.89 Statut : à jour — 9 nouveautés pertinentes identifiées Rapport écrit dans veille/veille-claude-code-2026-04-01.md

/claude-code-veille reference hooks

Fiche existante trouvée : fiches/guide-13-hooks-claude-code.md Vérification par rapport au changelog... 2 nouveautés manquantes Mise à jour proposée

/claude-code-veille reference buddy

Aucune fiche existante pour "buddy" Création de veille/reference-buddy.md (45 lignes)

/claude-code-veille migration

De : 2.1.86 → Vers : 2.1.89 1 breaking change détecté (thinking summaries désactivés) 0 variables supprimées Rapport écrit dans veille/migration-2026-04-01.md

---

Checklist finale

• La version installée est correctement détectée
• Le changelog est fetché et parsé
• Les changements sont filtrés par pertinence
• Le rapport est écrit dans un fichier (pas dans le chat)
• Les actions recommandées sont concrètes et vérifiables
• Les fiches existantes sont référencées quand elles existent