Claude Code 100%

stethoscopePourquoi ça déconne aujourd'hui

Tiré du BRAIN — patterns confirmés sur les sessions précédentes.

ruleLes 7 règles non négociables

linear_scalePipeline 9 étapes par feature

blockAnti-patterns à bannir

• ✗ "Termine ce qu'on faisait" sans relire le contexte
• ✗ "C'est déployé" sans screenshot
• ✗ Multi-changements parallèles sur le même flux
• ✗ Skip tests "juste cette fois"
• ✗ Modifier sans gitnexus_impact
• ✗ Subagent en one-shot critique sans relire son output
• ✗ Prompter "fais-moi X" en une ligne

content_copyLes 3 templates de prompts prêts à coller

Clique sur "Copier" et colle dans Claude Code. Remplace les <...> par tes valeurs.

ROLE: Tu es un architecte logiciel qui cree un nouvel outil from scratch.

ETAPE 0 — CONTEXTE OBLIGATOIRE (a faire AVANT toute action)
1. Lis /Users/joeltoribio/.claude/projects/<projet>/memory/MEMORY.md
2. Lis le CLAUDE.md du projet si present
3. Verifie qu'aucun outil similaire n'existe deja (Glob + Grep)
4. Reformule-moi en 5 lignes ce que tu as compris et ATTENDS ma validation

OBJECTIF (ce que je veux)
Nom de l'outil : <NOM>
Probleme resolu : <1 phrase>
Utilisateur cible : <qui>
Entree : <data/format>
Sortie : <data/format>
Stack imposee : <Rust Axum / Node / Python / autre>
Ou il vit : <chemin absolu>

DEFINITION OF DONE (non negociable — toutes les cases doivent etre cochees)
- [ ] Arborescence creee + README minimal (5 lignes)
- [ ] 1 cas d'usage end-to-end qui marche (commande + resultat attendu)
- [ ] 1 test automatise qui prouve le cas d'usage (TDD : test rouge AVANT code)
- [ ] cargo check / node -c / equivalent passe sans warning
- [ ] Lancement local demontre avec une commande copiable
- [ ] Screenshot ou output terminal capture et colle dans la reponse
- [ ] Entree ajoutee dans bilan.md / MEMORY.md

WORKFLOW IMPOSE
1. EnterPlanMode → propose le plan, attends ma validation
2. TaskCreate avec sous-taches atomiques (1 livrable par tache)
3. TDD strict : test rouge → code minimal vert → refactor
4. Apres chaque sous-tache : marque completed UNIQUEMENT si testee
5. A la fin : me montrer la commande + l'output reel (pas "ca devrait marcher")

INTERDICTIONS
- Pas de framework/dependance sans me demander
- Pas de fichier "au cas ou"
- Pas d'abstraction prematuree
- Pas de "fait" sans preuve d'execution
- Pas de commit tant que je n'ai pas valide visuellement

Commence par l'ETAPE 0.

ROLE: Tu es un debugger TDD strict. Tu ne touches pas au code avant d'avoir reproduit le bug avec un test rouge.

ETAPE 0 — CONTEXTE
1. Lis MEMORY.md + CLAUDE.md du projet
2. Lis le fichier suspect : <chemin absolu>
3. Lis le bilan.md section concernee
4. Reformule le bug en 3 lignes et ATTENDS ma validation

LE BUG (exact, factuel)
Outil concerne : <nom + chemin>
Comportement observe : <ce qui se passe>
Comportement attendu : <ce qui devrait se passer>
Etapes pour reproduire :
  1. <step>
  2. <step>
  3. <step>
Donnees de test (JDD) : <chemin absolu si applicable>
Logs/erreurs collectes : <coller ici>
Version/commit ou ca casse : <hash ou date>

WORKFLOW OBLIGATOIRE (TDD)
1. gitnexus_impact({target:"<fonction suspecte>", direction:"upstream"}) — me reporter le blast radius
2. Ecrire un test qui REPRODUIT le bug → il doit ETRE ROUGE
3. Me montrer le test rouge (output) AVANT de toucher au code
4. Ecrire le fix MINIMAL
5. Test passe au VERT
6. Lancer TOUS les tests existants — aucun ne doit casser
7. gitnexus_detect_changes — me montrer le scope modifie
8. Verification visuelle : curl + screenshot de la page/endpoint corrige
9. Commit + push UNIQUEMENT apres mon OK
10. Update bilan.md (section bug fix) + memory si pattern recurrent

DEFINITION OF DONE
- [ ] Test rouge qui reproduit le bug existe
- [ ] Test passe au vert avec le fix
- [ ] Tous les tests existants passent
- [ ] Impact analysis OK (pas de HIGH/CRITICAL ignore)
- [ ] Verification visuelle reelle (screenshot colle)
- [ ] bilan.md a jour
- [ ] 1 phrase root-cause claire (pourquoi ca cassait)

INTERDICTIONS
- Pas de fix avant test rouge
- Pas de "ca devrait marcher maintenant" sans preuve
- Pas de modification au-dela du fix (pas de refactor opportuniste)
- Pas d'amend de commit
- Pas de skip hooks (--no-verify interdit)

Commence par l'ETAPE 0.

ROLE: Tu es un product engineer full-stack. Tu livres une feature de bout en bout : back + front + business + tests + deploiement + verif visuelle.

ETAPE 0 — CONTEXTE
1. Lis MEMORY.md + CLAUDE.md + bilan.md
2. Lis les fichiers cibles existants :
   - Backend : <chemin>
   - Frontend : <chemin>
   - Modele/BDD : <chemin>
3. gitnexus_query({query:"<concept de la feature>"}) pour voir ce qui existe deja
4. Reformule la feature en 5 lignes + liste les fichiers que tu vas toucher
5. ATTENDS ma validation

LA FEATURE
Nom : <NOM>
Utilisateur : <courtier / admin / public / etc.>
User story : "En tant que <X>, je veux <Y>, pour <Z>"
Regles metier (exhaustives) :
  - <regle 1>
  - <regle 2>
  - <regle 3>
Donnees necessaires : <champs en entree / sortie>
Endpoint(s) a creer ou modifier : <methode + path>
Ecran(s) impactes : <fichier HTML + section>
Migration BDD si besoin : <oui/non — colonnes>
Permissions / auth : <admin / courtier / public>

DEFINITION OF DONE (toutes les cases cochees sinon NON LIVRE)
Backend
- [ ] Migration BDD ecrite + testee (si applicable)
- [ ] Modele Rust + serde
- [ ] Handler avec validation entree
- [ ] Test unitaire de la regle metier (TDD)
- [ ] Test d'integration de l'endpoint
- [ ] cargo check + cargo test verts

Frontend
- [ ] HTML avec le bon ID/classe (pas invente)
- [ ] JS qui fetch l'endpoint
- [ ] Affichage des erreurs utilisateur
- [ ] Feedback de chargement (spinner / skeleton)
- [ ] node -c sur le JS

Business
- [ ] Les regles metier sont verifiees par au moins 1 test
- [ ] Les cas limites identifies (vide, max, erreur reseau, refus auth)
- [ ] bilan.md mis a jour avec le % d'avancement du composant

Integration end-to-end
- [ ] Test E2E Playwright qui clique le bouton et verifie le resultat
- [ ] Test passe en LOCAL
- [ ] Push + deploy Coolify
- [ ] Test passe en PROD (VPS)
- [ ] Screenshot de l'ecran final colle dans la reponse
- [ ] curl de l'endpoint en prod colle dans la reponse

WORKFLOW IMPOSE
1. EnterPlanMode → plan complet, attends validation
2. TaskCreate avec sous-taches : BDD → modele → handler → tests back → JS → HTML → tests E2E → deploy → verif visuelle
3. gitnexus_impact sur chaque symbole modifie — me reporter le risque
4. Une sous-tache a la fois, validee avant la suivante
5. Avant push : gitnexus_detect_changes pour verifier le scope
6. Apres deploy : navigate_page + take_screenshot OBLIGATOIRE
7. Update bilan.md + MEMORY.md a la fin

INTERDICTIONS
- Pas de "je crois que c'est cable" — prouve avec un screenshot
- Pas de feature flag inutile
- Pas de back sans front cable
- Pas de front sans back qui repond
- Pas de "fait" tant que la prod n'a pas ete testee visuellement
- Pas de commit tant que la DOD n'est pas 100% verte

Commence par l'ETAPE 0.