HL ConsultingKNOWLEDGE HUB

← Journal

Cobra · Contexte Claude & méthode

Fichiers de contexte Claude Cobra : mise à jour + split de CLAUDE-dev

Claude · HL ·
doc meta en-cours Cobra

Contexte

Trois fichiers de référence alimentent le projet Claude dédié au dev Odoo Cobra (cobra_odoo_context.md, cobra_connexions_ecosysteme.md, CLAUDE-dev.md). Créés en mai 2026, ils étaient déjà obsolètes sur des points critiques : hébergement Odoo (SaaS → Odoo.sh), nom du repo GitHub, workflow de déploiement (Irokoo-gated → Hugo autonome depuis avril 2026), nombre de modules custom (9 → 13). Sans mise à jour, Claude démarrait chaque session avec un modèle mental faux de l'infra.

Besoin parallèle : CLAUDE-dev.md mélangeait des conventions génériques (valables pour tout projet dev HL Group) et des règles spécifiques Cobra. Le split permettait de partager le core générique avec les autres projets (Shopify, Haute Fidélité…) sans embarquer les règles Cobra.

Ce qui a été fait

Run 1 — mise à jour factuelle

Scan du repo ~/Cobra sur main pour établir les vérités à jour : git ls-tree → 13 modules cobra_* (pas 9) ; git log | grep CDC → dernier CDC en prod = CDC-19 (pas 17) ; lecture des __manifest__.py → versions et auteurs réels. Trois fichiers créés dans ~/Cobra/docs/ (inexistant auparavant), avec les corrections principales :

  • Odoo SaaS → Odoo.sh (cobrason : Shell / Editor / Logs / Builds / Backups) ;
  • repo GitHub : nom corrigé (dépôt privé) ;
  • déploiement : Hugo déploie seul en prod depuis ~avril 2026 (cherry-pick sur main) ;
  • preprod = staging Hugo ; preprod3 = Irokoo, ne jamais y toucher ;
  • branche prod = main (pas master) ;
  • 9 → 13 modules ; dernier CDC = CDC-19 (prochain = CDC-20) ;
  • accès Claude : XML-RPC + shell Odoo.sh (env.cr.commit() obligatoire).

Commit + PR #385 vers preprod.

Run 2 — corrections résiduelles + split + renommage

  • Sogetronic : le matching en prod est par code fournisseur (product.supplierinfo.product_code), pas EAN-13 comme indiqué. Volume de produits peuplés non trouvé dans le log → marqué [à confirmer par Hugo] plutôt qu'un chiffre inventé.
  • x_qty_paid : aucun commit de backfill sur les PO historiques → cobra_vendor_payment_confirm rétrogradé de ✅ à 🔄.
  • CDC-17/18 : confirmé dans le git log (field_security = CDC-17, dashboard achats = CDC-18). Rien à corriger.

Split de CLAUDE-dev.md : d'un côté le core générique HL Group (« Avant de coder », « Discipline de code », « Livrables » + une nouvelle section Loops autonomes : critère de succès exécutable, max 5 itérations, PROGRESS.md, checkpoint humain avant action irréversible, actions interdites listées dans l'extension) ; de l'autre l'extension Cobra (CLAUDE-dev-cobra.md : règles dures déploiement + synchro preprod↔main, stack Odoo/Shopify/SEO, CDC, sujets en cours, contacts).

Renommage (git mv) vers la convention CLAUDE-* : cobra_odoo_context.md → CLAUDE-cobra-odoo-context.md ; cobra_connexions_ecosysteme.md → CLAUDE-cobra-connexions.md ; ajout de CLAUDE-dev-cobra.md. Convention posée en tête des fichiers renommés : « CLAUDE-{domaine}.md = générique, CLAUDE-{domaine}-{projet}.md = spécifique. » Toutes les références croisées internes mises à jour (anciens → nouveaux noms), zéro résidu vérifié par grep. Bonus : claude-cobra-bigquery_setup_summary.md → CLAUDE-cobra-bigquery.md.

Décisions et alternatives écartées

  • Nouveau dossier docs/ versionné plutôt qu'édition sur place de fichiers éparpillés (Desktop, Downloads, archive) : seule option propre — ça versionne les docs avec le code.
  • Split immédiat plutôt que plus tard, pour éviter un 3ᵉ aller-retour ; risque de perte de contenu entre les deux fichiers couvert par un diff manuel.
  • 3 commits atomiques visés mais l'ordre des git add a tout fait tomber dans un seul commit (b401829) : pas idéal pour la bisectabilité, mais contenu correct.

Galères et comment on a réglé

  • Fichiers introuvables : cobra_connexions_ecosysteme.md retrouvé dans ~/Downloads/ via find ~ -maxdepth 6 ; cobra_odoo_context.md en _archive/ sur le Desktop.
  • Section « Auteurs mixtes » auto-contradictoire (énumérait 5 modules Cobra en disant « 4 ») → corrigé au run 2 : 7 Irokoo + 5 Cobra + 1 mixte (cobra_purchase).
  • Sogetronic : les docs disaient « 175 produits matchés par EAN-13 » ; le git log (bc18b4e) dit « matching par code fournisseur ». Double erreur (méthode + chiffre) ; volume non dans le log → [à confirmer].

Résultat & suite

  • 4 fichiers dans ~/Cobra/docs/ : CLAUDE-cobra-odoo-context.md, CLAUDE-cobra-connexions.md, CLAUDE-dev.md (core), CLAUDE-dev-cobra.md.
  • PR #385 ouverte vers preprod ; convention CLAUDE-* appliquée et documentée ; renommage hors-repo CLAUDE-cobra-bigquery.md.

Suite : merger #385 sur preprod (build Odoo.sh pour vérification) ; re-uploader dans Claude.ai (projet Odoo Cobra : 4 fichiers, supprimer les anciens ; autres projets dev : CLAUDE-dev.md core seul) ; confirmer le volume produits Sogetronic + statut Merchant Center / Search Console BigQuery ; backfill x_qty_paid sur les PO historiques ; mettre à jour le ~/Cobra/CLAUDE.md local (référence encore SaaS, master, 11 modules, CDC-18).