Cardigan-AI — Comment utiliser la plateforme

Recommande

⌨

Claude Code Local

Equipe technique — Terminal

$ $ $ $ Inclus

0$ / campagne — inclus dans l'abonnement Claude (Max/Pro)

/campaign — Pipeline complet en 1 commande
/brief — Import Wrike + creation Asana
/qa — Validation QA avec Chrome staging
/calendrier — Timeline animee par brand
/compare-brands — Diff structurel XML
10+ commandes slash disponibles
Sub-agents Haiku/Sonnet/Opus
Feedback partage equipe via /feedbacks
Pre-flight check + validation bilingue

Necessite terminal + Claude Code installe
Mac/Linux seulement

Recommande

☁

Claude Code Web

Equipe a distance — Navigateur

$ $ $ $ Inclus

0$ / campagne — inclus dans l'abonnement Claude (Max/Pro)

Memes commandes slash que local
Token seeding via env vars
Auto-seed au demarrage de session
Feedback partage equipe
Acces au pipeline complet

Pas de Chrome MCP (QA staging impossible)
Pas d'acces fichiers locaux
Tokens via CARDIGAN_SEED_* env vars
Pas de /calendrier (pas de navigateur local)

⚙

Asana (automatique)

Equipe operations — Zero technique

$ $ $ $ Faible

~0.50-1$ / campagne (Haiku + scripts, pas de conversation)

Change le statut a "Generate" dans Asana
Le pipeline se declenche automatiquement
XMLs generes sans intervention
Statut "Brief-AI" pour le pipeline complet
Polling toutes les 15 min (LaunchAgent)

Fire-and-forget (pas de feedback visuel)
Webhook: necessite URL publique
Pas de QA ni preview
Pas de customisation du pipeline

★

Webapp

Tout le monde — Interface chat

$ $ $ $ Moyen

~1-4$ / campagne (model routing Haiku/Sonnet/Opus) + VM ~0$/mois

Chat conversationnel avec Claude
Liste des campagnes importees
Lancer le pipeline depuis l'interface
Historique des sessions + usage tokens
Brand learnings inline
Session replay pour analyse

Necessite le serveur FastAPI (port 8000)
Pas de QA Chrome staging
Depends du portail OAuth pour les tokens
En cours de developpement

	Local	Web	Asana	Webapp
Import brief Wrike	Oui	Oui	Auto	Oui
Analyse brief (Opus)	Oui	Oui	Auto	Oui
Scope Claude vs Manuel	Oui	Oui	—	Oui
Generation XML	Oui	Oui	Oui	Oui
Preview dry-run	Oui	Oui	—	Partiel
QA staging Chrome	Oui	—	—	—
QA copy-check (prod)	Oui	Oui	—	Oui
Calendrier animation	Oui	—	—	—
Comparaison brands	Oui	Oui	—	—
Feedback equipe	Oui	Oui	—	Inline
Suivi tokens/usage	—	—	—	Oui
Session replay	—	—	—	Oui
Zero technique requis	—	—	Oui	Oui
Cout par campagne	0$ (inclus)	0$ (inclus)	~0.50-1$	~1-4$
Cout fixe / mois	Abo Claude (Max/Pro)	Abo Claude (Max/Pro)	0$ (API only)	~0$ (VM Oracle)

Reference des commandes

Clique sur une commande pour voir en detail comment l'utiliser et ce qui se passe apres.

Pipeline principal

▶ /campaign Pipeline complet : brief → analyse → scope → XML Multi-modele

# Colle un lien Wrike — tout le pipeline s'execute
$ /campaign https://www.wrike.com/open.htm?id=4402185166

# Ou reprendre un pipeline interrompu
$ /campaign input/briefs/20260315-mothers-day-aesop

Pipeline declenche (7 etapes)

0 Import brief — Wrike API → telechargement PDFs, images, ZIPs → creation tache Asana Haiku

1 Analyse brief — Lecture PDF, classification job type/subtype, extraction copy EN/FR, verification completude, statut ready/blocked Opus

2 Scope — Repartition Claude vs Manuel, estimation effort, generation qa_checklist Sonnet

3a Build spec — build_campaign_spec.py assemble la spec JSON (fusion analysis + scope + catalog) Script

3b WebDAV — package_webdav.py classifie les images et genere le manifest d'upload Script

3c Completion copy — Remplissage des champs TODO (texte, descriptions) en relisant le brief Sonnet

4 Generation XML — generate_xml.py produit les XMLs SFCC + preview HTML + validation structurelle Script

Fichiers produits

wrike_metadata.json analysis.json scope.json campaign-spec.json output/xml/*.xml preview.html campaign-state.json

Cout : 0$ (inclus dans l'abonnement Claude)

Duree : ~5-15 min

Reprise : Oui (etat machine)

Reprise mid-pipeline : Si le pipeline est interrompu (compaction, timeout), relancer /campaign avec le meme chemin — il reprend depuis le current_step sauvegarde dans campaign-state.json.

▶ /brief Importer un brief Wrike + creer la tache Asana Haiku

$ /brief https://www.wrike.com/open.htm?id=4402185166

Pipeline declenche

1 Wrike API — Extraction metadata (titre, brand, dates, description, sous-taches)

2 Telechargement — PDFs, images, ZIPs, XLSXs de toutes les sous-taches

3 Asana — Creation tache avec lien bidirectionnel Wrike ↔ Asana

4 Drive — Upload assets vers Google Drive (dossier campagne)

Fichiers produits

input/briefs/{date}-{slug}/ wrike_metadata.json *.pdf, *.jpg, *.zip

Cout : ~0.10$

Duree : ~1-2 min

API uniquement : Utilise toujours l'API Wrike pour acceder aux briefs, jamais Chrome. Le token Wrike doit etre configure via le portail OAuth.

▶ /brief-analyse Analyser un brief : classifier, verifier, evaluer le statut Opus

# Par lien Wrike, Asana, Drive, ou chemin local
$ /brief-analyse https://www.wrike.com/open.htm?id=4402185166
$ /brief-analyse input/briefs/20260315-mothers-day

# Analyser TOUS les briefs non analyses
$ /brief-analyse all

Pipeline declenche

1 Lecture brief — PDF client, wrike_metadata, contenu ZIPs

2 Brand learnings — Chargement patterns historiques depuis input/brand-learnings/{brand}.json

3 Classification — Job type (recurring/ad_hoc), subtype (HPB, Landing page, PDP, Promo/GWP, CLP, Text update...)

4 Extraction — Copy EN/FR, assets, dates (conversion UTC, EDT/EST), details promo

5 Verification — Checklist completude : dates, copy, images, scope, legal text, deactivation

6 Statut — ready | ready_with_caveats | blocked + commentaire Asana

Fichiers produits

analysis.json

Cout : ~1-3$

Duree : ~2-5 min

Modele : Opus (jugement critique)

Pourquoi Opus ? L'analyse du brief est l'etape la plus critique — une mauvaise interpretation se propage dans tout le pipeline. Opus detecte les ambiguites et les elements manquants qu'un modele leger manquerait.

▶ /scope Repartition Claude vs Manuel + estimation effort Sonnet

$ /scope input/briefs/20260315-mothers-day

Pipeline declenche

1 Lecture analyse — Charger analysis.json (job type, pages, missing items)

2 Classification 14 patterns — Chaque page/bloc est classifie : Landing Page, Homepage, PDP, CLP, Header Banner, Promo/GWP, etc.

3 Repartition — Pour chaque XML : assigner a Claude (auto) ou Manuel (humain), estimer effort en points/temps

4 QA checklist — Generation dynamique : pre_import (copy, encoding, IDs) + post_import (staging, visual, timing)

Fichiers produits

scope.json

Cout : ~0.30$

Duree : ~1-2 min

La qa_checklist generee est contextuelle : si la campagne contient une promo, les checks legal text et cart validation sont ajoutes automatiquement. Si c'est un PDP, les checks prix et description sont inclus.

▶ /generate Declencher la generation XML sans refaire l'analyse Sonnet

# Par GID Asana, nom campagne, ou chemin
$ /generate 1213648408985881
$ /generate mothers-day

# Mode preview (pas d'execution)
$ /generate mothers-day --dry-run

Pipeline declenche

1 Resolution — Resoudre input vers le dossier brief (verifie presence analysis.json + scope.json)

2 Build spec — build_campaign_spec.py → campaign-spec.json Script

3 WebDAV + completion — Classification images + remplissage TODOs copy Sonnet

4 XML + preview — generate_xml.py + preview_import.py + upload Drive Script

5 Asana — Commentaire recap + transition statut → « A QA »

Fichiers produits

output/xml/*.xml output/reports/preview.html Lien Google Drive

Cout : ~0.50-1$

Duree : ~2-5 min

Utile quand l'analyse et le scope sont deja faits et que tu veux juste regenerer les XMLs (ex: apres correction du brief). Le mode --dry-run affiche un tree view sans executer.

QA & Validation

▶ /qa Validation post-import sur staging avec Chrome Opus + Chrome

# QA une tache Wrike (copy-check production)
$ /qa https://www.wrike.com/open.htm?id=4402185166

# QA staging avec Chrome (post-import)
$ /qa input/briefs/20260315-mothers-day --chrome

# QA manuelle (checklist sans Chrome)
$ /qa input/briefs/20260315-mothers-day --manual

Pipeline declenche

1 Chargement — Lecture scope.json → qa_checklist (pre_import + post_import checks)

2 Resolution brand — Brand → staging URL (8 domaines) + construction __siteDate pour time-travel

3 Navigation Chrome — Visite pages staging, screenshot, extraction texte via a11y tree Chrome MCP

4 Comparaison — Copy brief vs copy staging, validation prix/images/legal text Opus

5 Rapport — Resultats par check (pass/fail/warning) + screenshots galerie

6 Learnings — build-brand-learnings.py compile patterns pour futures analyses

Fichiers produits

qa_report.json qa-screenshots/*.png brand-learnings update

Cout : ~2-5$

Duree : ~5-15 min

Requis : Chrome MCP (local seulement)

Staging uniquement, jamais production. Le parametre __siteDate permet le time-travel sur staging pour valider les dates d'activation/desactivation. La QA detecte aussi le English fallback sur les pages FR (indicateur de traduction manquante).

▶ /qa-screenshots Capture screenshots staging + upload Drive Chrome MCP

$ /qa-screenshots

Pipeline declenche (7 etapes)

1 Config — Lecture page list (URL + locale + device: desktop/mobile)

2 Navigation — Chrome DevTools navigue chaque page, dismiss popups

3 Emulation — Viewports adaptes (1920x1080, 375x812, etc.)

4 Capture — Screenshot fullPage pixel-perfect + console errors

5 Evaluation — Evaluation visuelle de chaque capture

6 Upload — Screenshots vers Google Drive (dossier QA evidence)

7 Retro — Learnings obligatoires post-session

Fichiers produits

output/qa-screenshots/{campaign}/01-*.png manifest.json

Cout : ~0.50$

Requis : Chrome MCP (local seulement)

Outils & Utilitaires

▶ /status Statut Wrike + Asana + fichiers locaux Haiku

$ /status https://www.wrike.com/open.htm?id=4402185166

Ce qui se passe

1 Wrike API — Recupere le statut courant de la tache

2 Asana API — Statut correspondant (via wrike_metadata.json)

3 Fichiers locaux — Presence de analysis.json, scope.json, XMLs, qa_report.json

4 Affichage — Vue consolidee de l'avancement dans le pipeline

Cout : ~0.02$

Fichiers : Aucun (lecture seule)

▶ /compare-brands Diff structurel entre 2 brands SFCC Script Python

$ /compare-brands aesop armani

Ce qui se passe

1 Parsing XML — Lecture des backups XML des 2 brands (content library exports)

2 Analyse — Type mapping, IDs partages, hierarchie sections, conventions naming

3 Rapport HTML — 5 sections : mapping, collisions IDs, structure, naming, recommandations

Fichiers produits

output/reports/{brand1}-vs-{brand2}-comparison.html

Cout : 0$ (script pur)

Duree : ~30 sec

▶ /calendrier Timeline Gantt des animations SFCC par brand Script Python

$ /calendrier aesop

Ce qui se passe

1 Extraction dates — Lit les XMLs pour extraire valid_from/valid_to de chaque composant

2 Groupement — Par type : HPB, Under-HP, Header-Banner, CLP, Promo, Content Tile, Section

3 Gantt HTML — Barres temporelles interactives avec detection zero-gap

Fichiers produits

output/reports/{brand}-timeline.html

Cout : 0$ (script pur)

Requis : Local seulement

▶ /ingest Import batch 50-100+ taches Wrike pour compiler learnings Haiku

# Importer un batch de taches historiques
$ /ingest (coller liste URLs Wrike)

Ce qui se passe

1 Deduplication — Supprime les URLs en double

2 Import sequentiel — wrike-pull.py par tache (rate limit : 1 req/sec)

3 Compilation — build-brand-learnings.py agrege les patterns par brand

Fichiers produits

input/briefs/{date}-*/ (multiples) input/brand-learnings/{brand}.json

Cout : ~1-5$ (batch)

Duree : ~20-60 min

Les brand learnings compiles sont ensuite utilises par /brief-analyse pour pre-identifier les elements manquants recurrents et ajuster les statuts automatiquement.

Equipe & Collaboration

▶ /feedbacks Sauvegarder un feedback equipe dans la memoire partagee Haiku

$ /feedbacks Toujours verifier les traductions FR avant import

Ce qui se passe

1 Creation — Fichier feedback dans shared-feedback/feedbacks/{date}_{user}_{slug}.md

2 Contradiction check — Verifie si le feedback contredit un feedback existant

3 Index — rebuild-feedback-index.py met a jour FEEDBACK-INDEX.md

4 Rappel — « Pour partager avec l'equipe, lance ./sync.sh »

Fichiers produits

shared-feedback/feedbacks/{date}_{user}_{slug}.md FEEDBACK-INDEX.md (updated)

▶ /claim Reserver une tache pour eviter le travail en double Haiku

$ /claim https://www.wrike.com/open.htm?id=4402185166

Ce qui se passe

1 Verification — Personne d'autre ne travaille deja sur cette tache ?

2 Reservation — Fichier claim dans shared-feedback/claims/{campaign-id}.json

3 Active tasks — Mise a jour de active-tasks.md (qui travaille sur quoi)

Fichiers produits

shared-feedback/claims/{id}.json active-tasks.md (updated)

▶ /contradictions Detecter et resoudre les conflits entre feedbacks equipe Opus

$ /contradictions

Ce qui se passe

1 Scan — Charge tous les feedbacks existants

2 Analyse — Detecte les feedbacks contradictoires (meme sujet, directives opposees)

3 Resolution — 4 options : garder A, garder B, merger, faux positif

4 Sauvegarde — Decision dans shared-feedback/contradictions/

Comment utiliser Cardigan-AI

Le pipeline en un coup d'oeil

Claude Code Local

Claude Code Web

Asana (automatique)

Webapp

Matrice de capacites

Reference des commandes

Parcours typiques

Pour commencer