source-command-cowork-veille

Use this skill when the user asks to run the migrated source command cowork-veille.

Command Template

Codex Cowork Product Watch

Cherche sur le web ce qui est nouveau sur la desktop app Codex, compare avec le CHANGELOG local, et identifie les gaps non documentés.

Pipeline complet :

/cowork:veille          →  Découvre les gaps, propose des entrées CHANGELOG
  ↓ (review manuelle)
/cowork:update-releases →  Sync CHANGELOG → YAML → TS

Step 1: Parse Arguments

• --deep : utilise perplexitydeepresearch au lieu de perplexity_search (plus lent, plus exhaustif)
• --since <YYYY-MM-DD> : ne considérer que les annonces après cette date ; si absent, utiliser la date du dernier entry CHANGELOG
• --sources <all|blog|reddit|press> : filtrer les sources (défaut : all)

Step 2: Lire l'état actuel du CHANGELOG

Lire /Users/florianbruniaux/Sites/perso/Codex-cowork-guide/CHANGELOG.md.

Extraire :

1. Date baseline : date du premier ## [X.Y.Z] - YYYY-MM-DD (entrée la plus récente) → utilisée comme --since automatique si non fourni
2. Features documentées : liste plate de tous les items bullet de toutes les sections (Added, Changed, Fixed) de toutes les versions versionnées. Ignorer les métadonnées de versioning.
3. Section [Unreleased] : noter son contenu s'il est non vide.

Afficher en debug :

📋 CHANGELOG baseline: YYYY-MM-DD (vX.Y.Z)
📦 Features documentées: N items
📝 [Unreleased]: X items

Step 3: Recherches web (en parallèle)

Lancer les 4 queries en parallèle via perplexitysearch (ou perplexitydeep_research si --deep).

⚠️ Ne PAS utiliser "Cowork" dans les queries — terme interne, non utilisé publiquement. ⚠️ Filtrer les résultats mentionnant "terminal", "CLI", "npm", "Codex", "Codex" — c'est un autre produit.

Si --sources blog : queries 1 + 2 seulement. Si --sources reddit : query 3 seulement. Si --sources press : query 4 seulement. Si --sources all ou absent : toutes les 4.

Appliquer le filtre --since pour ignorer les features annoncées avant la date baseline.

Step 4: Fetch des pages de référence

Faire WebFetch sur ces 2 URLs en parallèle :

• https://docs.anthropic.com/en/docs/Codex-ai/Codex-desktop — docs officielles desktop
• https://www.anthropic.com/news — blog Anthropic (scanner pour mentions desktop/features)

Skip silencieux si 404, timeout, ou redirect vers une page non pertinente. Ne pas bloquer sur les erreurs de fetch.

Step 5: Comparer et scorer

Pour chaque feature/claim trouvée dans les résultats de recherche et les pages fetchées :

1. Extraire la claim concrète : plugin X, capability Y, platform Z — quelque chose de testable et précis
2. Fuzzy match contre la liste des features documentées extraite au Step 2 :

- Match exact ou quasi-exact → DÉJÀ DOCUMENTÉ, skip - Match partiel ou ambigu → PAS CLAIR, noter - Aucun match → NOUVEAU GAP, retenir

1. Scorer la confiance selon la source :

- HIGH : anthropic.com, docs.anthropic.com, annonce officielle - MEDIUM : presse tech réputée (TechCrunch, The Verge, Ars Technica, etc.) - LOW : Reddit, forums, posts individuels non vérifiés

Dédupliquer les claims identiques trouvées dans plusieurs sources (garder la source la plus fiable).

Step 6: Afficher le Gap Report

=== Codex Cowork Product Watch ===
Baseline: YYYY-MM-DD (vX.Y.Z)
Sources: 4 queries + 2 anchor pages
Filtre: features après YYYY-MM-DD

--- NOUVEAUX GAPS (pas dans CHANGELOG) ---

[HIGH] <Feature name> (source officielle, <date>)
  Source: <URL>
  Résumé: <1-2 phrases factuelles>
  → Catégorie suggérée: Added | Changed | Fixed

[MEDIUM] <Feature name> (<publication>, <date>)
  Source: <URL>
  Résumé: <1-2 phrases>
  → Catégorie suggérée: Added

[LOW] <Feature name> (Reddit, non confirmé)
  Source: <URL>
  → Vérification nécessaire avant documentation

--- DÉJÀ DOCUMENTÉ (<N> features matchées) ---
<liste condensée ou "Tout semble à jour.">

--- PAS CLAIR (<N> résultats ambigus) ---
<items avec incertitude, ex: "Mention de X mais contexte flou">

---
Total gaps HIGH+MEDIUM : N
Total gaps LOW (non confirmés) : N

Si aucun gap trouvé : afficher "✅ Aucun gap détecté. CHANGELOG à jour au YYYY-MM-DD." et terminer.

Step 7: Draft CHANGELOG (optionnel)

Si des gaps HIGH ou MEDIUM ont été trouvés, demander :

"Rédiger des entrées CHANGELOG pour les gaps confirmés (HIGH + MEDIUM) ? (y/n)"

Si n ou pas de réponse → terminer ici.

Si y :

1. Générer les entrées au format Keep-a-Changelog pour chaque gap HIGH et MEDIUM
2. Les grouper sous ### Added, ### Changed, ### Fixed selon la catégorie suggérée
3. Les ajouter dans la section ## [Unreleased] du CHANGELOG (en dessous de la ligne ## [Unreleased])
4. Si la section [Unreleased] est vide : ajouter les sous-sections nécessaires
5. Si elle contient déjà des items : ajouter les nouveaux items dans les sous-sections existantes ou créer les sous-sections manquantes

Format des entrées générées :

## [Unreleased]

### Added
- <Feature X> : <description factuelle, 1 ligne, basée sur la source>
- <Feature Y> : <description>

Afficher confirmation :

✅ <N> entrées ajoutées dans [Unreleased]
   → Relire CHANGELOG.md avant de couper une version
   → Puis : /cowork:update-releases pour sync YAML + landing

Les gaps LOW ne sont PAS ajoutés automatiquement — indiquer à l'utilisateur de les vérifier manuellement s'il le souhaite.