Skip to content

Latest commit

 

History

History
398 lines (313 loc) · 53.9 KB

File metadata and controls

398 lines (313 loc) · 53.9 KB

🌍 English | 中文 | 日本語 | Français | Русский | العربية

claude-code-best-practice

du vibe coding a l'ingenierie agentique - la pratique rend Claude parfait

updated with Claude Code

Best Practice Implemented Orchestration Workflow Claude Boris Community Click on these badges below to see the actual sources
= Agents · = Commands · = Skills

Mascotte Claude Code en train de sauter

🧠 CONCEPTS

Fonctionnalite Emplacement Description
Subagents .claude/agents/<name>.md Best Practice Implemented Acteur autonome dans un contexte isole — outils personnalises, permissions, modele, memoire et identite persistante
Commands .claude/commands/<name>.md Best Practice Implemented Connaissances injectees dans le contexte existant — modeles de prompts simples invoques par l'utilisateur pour l'orchestration des workflows
Skills .claude/skills/<name>/SKILL.md Best Practice Implemented Connaissances injectees dans le contexte existant — configurables, prechargeable, auto-decouvrables, avec bifurcation de contexte et divulgation progressive · Skills officiels
Workflows .claude/commands/weather-orchestrator.md Orchestration Workflow
Hooks .claude/hooks/ Best Practice Implemented Gestionnaires definis par l'utilisateur (scripts, HTTP, prompts, agents) qui s'executent en dehors de la boucle agentique sur des evenements specifiques · Guide
MCP Servers .claude/settings.json, .mcp.json Best Practice Implemented Connexions Model Context Protocol vers des outils externes, bases de donnees et API
Plugins paquets distribuables Ensembles de skills, subagents, hooks, MCP servers et LSP servers · Marketplaces · Creer des Marketplaces
Settings .claude/settings.json Best Practice Implemented Systeme de configuration hierarchique · Permissions · Model Config · Output Styles · Sandboxing · Keybindings · Fast Mode
Status Line .claude/settings.json Best Practice Implemented Barre d'etat personnalisable affichant l'utilisation du contexte, le modele, le cout et les informations de session
Memory CLAUDE.md, .claude/rules/, ~/.claude/rules/, ~/.claude/projects/<project>/memory/ Best Practice Implemented Contexte persistant via les fichiers CLAUDE.md et les imports @path · Auto Memory · Rules
Checkpointing automatique (base sur git) Suivi automatique des modifications de fichiers avec retour en arriere (Esc Esc ou /rewind) et resume cible
CLI Startup Flags claude [flags] Best Practice Drapeaux de ligne de commande, sous-commandes et variables d'environnement pour lancer Claude Code · Interactive Mode
AI Terms Best Practice Ingenierie agentique · Ingenierie du contexte · Vibe Coding
Best Practices Bonnes pratiques officielles · Prompt Engineering · Etendre Claude Code

🔥 Nouveautes

Fonctionnalite Emplacement Description
Power-ups /powerup Best Practice Lecons interactives enseignant les fonctionnalites de Claude Code avec des demos animees (v2.1.90)
Ultraplan beta /ultraplan Elaborez des plans dans le cloud avec revision en navigateur, commentaires en ligne et execution flexible — a distance ou teleporte vers le terminal
Claude Code Web beta claude.ai/code Executez des taches sur l'infrastructure cloud — taches de longue duree, correction automatique de PR, sessions paralleles sans configuration locale · Taches planifiees
No Flicker Mode beta CLAUDE_CODE_NO_FLICKER=1 Best Practice Rendu sans scintillement sur ecran alternatif avec support souris, memoire stable et defilement integre — apercu de recherche optionnel
Computer Use beta computer-use MCP server Laissez Claude controler votre ecran — ouvrir des apps, cliquer, taper et capturer votre ecran sur macOS · Desktop
Auto Mode beta claude --enable-auto-mode Best Practice Un classificateur de securite en arriere-plan remplace les demandes de permission manuelles — Claude decide ce qui est sur tout en bloquant les injections de prompts et les escalades risquees · Lancez avec claude --enable-auto-mode (ou --permission-mode auto), ou basculez avec Shift+Tab pendant une session · Blog
Channels beta --channels, base sur plugin Envoyez des evenements depuis Telegram, Discord ou des webhooks vers une session en cours — Claude reagit pendant votre absence · Reference
Slack @Claude dans Slack Mentionnez @Claude dans le chat d'equipe avec une tache de code — redirige vers des sessions Claude Code web pour corrections de bugs, revues de code et execution de taches en parallele
Code Review beta GitHub App (geree) Best Practice Analyse multi-agent de PR qui detecte les bugs, vulnerabilites de securite et regressions · Blog
GitHub Actions .github/workflows/ Automatisez les revues de PR, le triage des issues et la generation de code dans les pipelines CI/CD · GitLab CI/CD
Chrome beta --chrome, extension Best Practice Automatisation du navigateur via Claude in Chrome — testez des apps web, debuguez avec la console, automatisez des formulaires, extrayez des donnees de pages
Scheduled Tasks /loop, /schedule, outils cron Best Practice Implemented /loop execute des prompts localement sur un planning recurrent (jusqu'a 3 jours) · /schedule execute des prompts dans le cloud sur l'infrastructure Anthropic — fonctionne meme quand votre machine est eteinte · Annonce
Voice Dictation beta /voice Best Practice Saisie vocale appuyer-pour-parler avec support de 20 langues et touche d'activation reconfigurable
Simplify & Batch /simplify, /batch Best Practice Skills integres pour la qualite du code et les operations en masse — simplify refactorise pour la reutilisation et l'efficacite, batch execute des commandes sur plusieurs fichiers
Agent Teams beta integre (var env) Best Practice Implemented Plusieurs agents travaillant en parallele sur le meme codebase avec coordination des taches partagee
Remote Control /remote-control, /rc Best Practice Continuez les sessions locales depuis n'importe quel appareil — telephone, tablette ou navigateur · Headless Mode
Git Worktrees integre Best Practice Branches git isolees pour le developpement parallele — chaque agent obtient sa propre copie de travail
Ralph Wiggum Loop plugin Best Practice Implemented Boucle de developpement autonome pour les taches de longue duree — itere jusqu'a achevement

separateur de section

Orchestration Workflow

Voir orchestration-workflow pour les details d'implementation du patron Command Agent Skill.

Flux d'architecture Command Skill Agent

Demo du Workflow d'orchestration

How to Use

claude
/weather-orchestrator

separateur de section

⚙️ WORKFLOWS DE DEVELOPPEMENT

Tous les workflows majeurs convergent vers le meme patron architectural : Recherche → Plan → Execution → Revue → Livraison

Nom Specificite Plan
Everything Claude Code 146k instinct scoring AgentShield multi-lang rules planner 47 82 182
Superpowers 141k TDD-first Iron Laws whole-plan review writing-plans 5 3 14
Spec Kit 86k spec-driven constitution 22+ tools speckit.plan 0 9+ 0
gstack 67k role personas /codex review parallel sprints autoplan 0 0 37
Get Shit Done 49k fresh 200K contexts wave execution XML plans gsd-planner 24 68 0
BMAD-METHOD 44k full SDLC agent personas 22+ platforms bmad-create-prd 0 0 39
OpenSpec 38k delta specs brownfield artifact DAG opsx:propose 0 11 0
oh-my-claudecode 26k teams orchestration tmux workers skill auto-inject ralplan 19 0 37
Compound Engineering 14k Compound Learning Multi-Platform CLI Plugin Marketplace ce-plan 51 4 44
HumanLayer 10k RPI context engineering 300k+ LOC create_plan 6 27 0

Autres

separateur de section

💡 ASTUCES ET CONSEILS (69)

🚫👶 = ne pas micro-gerer

Prompting · Planification · CLAUDE.md · Agents · Commands · Skills · Hooks · Workflows · Avance · Git / PR · Debugging · Utilitaires · Quotidien

Community

Prompting (3)

Astuce Source
mettez Claude au defi — "passe-moi un oral sur ces changements et ne fais pas de PR tant que je n'ai pas reussi ton test." ou "prouve-moi que ca marche" et faites comparer a Claude entre main et votre branche 🚫👶 Boris
apres une correction mediocre — "sachant tout ce que tu sais maintenant, recommence de zero et implemente la solution elegante" 🚫👶 Boris
Claude corrige la plupart des bugs tout seul — collez le bug, dites "corrige", ne micro-gerez pas la methode 🚫👶 Boris

Planification/Specs (6)

Astuce Source
commencez toujours avec le plan mode Boris
commencez avec une spec ou un prompt minimal et demandez a Claude de vous interviewer avec l'outil AskUserQuestion, puis creez une nouvelle session pour executer la spec Thariq
faites toujours un plan par phases avec validation, chaque phase ayant plusieurs tests (unitaires, automatisation, integration)
lancez un second Claude pour reviser votre plan en tant qu'ingenieur senior, ou utilisez le cross-model pour la revue Boris
redigez des specs detaillees et reduisez l'ambiguite avant de deleguer le travail — plus vous etes specifique, meilleur est le resultat Boris
prototype > PRD — construisez 20-30 versions au lieu d'ecrire des specs, le cout de construction est faible alors tentez plusieurs essais Boris Video

CLAUDE.md (7)

Astuce Source
CLAUDE.md devrait viser moins de 200 lignes par fichier. 60 lignes chez humanlayer (toujours pas garanti a 100%) Boris Dex
enveloppez les regles CLAUDE.md specifiques au domaine dans des balises <important if="..."> pour empecher Claude de les ignorer lorsque les fichiers deviennent longs Dex
utilisez plusieurs CLAUDE.md pour les monorepos — chargement ascendant + descendant
utilisez .claude/rules/ pour decouper les instructions volumineuses
memory.md, constitution.md ne garantit rien
tout developpeur devrait pouvoir lancer Claude, dire "lance les tests" et que ca marche du premier coup — si ce n'est pas le cas, votre CLAUDE.md manque les commandes essentielles de setup/build/test Dex
gardez les codebases propres et finissez les migrations — des frameworks partiellement migres perturbent les modeles qui risquent de choisir le mauvais patron Boris Video
utilisez settings.json pour les comportements imposes par le harness (attribution, permissions, modele) — ne mettez pas "NE JAMAIS ajouter Co-Authored-By" dans CLAUDE.md quand attribution.commit: "" est deterministe davila7

Agents (4)

Astuce Source
creez des sub-agents specifiques aux fonctionnalites (contexte supplementaire) avec des skills (divulgation progressive) plutot que des agents generiques qa, ingenieur backend Boris
dites "utilise des subagents" pour consacrer plus de puissance de calcul a un probleme — deleguez les taches pour garder votre contexte principal propre et concentre 🚫👶 Boris
agent teams avec tmux et git worktrees pour le developpement parallele
utilisez le test time compute — des fenetres de contexte separees donnent de meilleurs resultats ; un agent peut causer des bugs et un autre (meme modele) peut les trouver Boris

Commands (3)

Astuce Source
utilisez des commands pour vos workflows plutot que des sub-agents Boris
utilisez des slash commands pour chaque workflow de "boucle interne" que vous faites plusieurs fois par jour — evite de repeter les prompts, les commands vivent dans .claude/commands/ et sont versionnees dans git Boris
si vous faites quelque chose plus d'une fois par jour, transformez-le en skill ou command — creez des commands /techdebt, context-dump ou analytics Boris

Skills (9)

Astuce Source
utilisez context: fork pour executer un skill dans un subagent isole — le contexte principal ne voit que le resultat final, pas les appels d'outils intermediaires. Le champ agent permet de definir le type de subagent Lydia
utilisez des skills dans des sous-dossiers pour les monorepos
les skills sont des dossiers, pas des fichiers — utilisez les sous-repertoires references/, scripts/, examples/ pour la divulgation progressive Thariq
integrez une section Pieges dans chaque skill — contenu a plus forte valeur, ajoutez les points de defaillance de Claude au fil du temps Thariq
le champ description d'un skill est un declencheur, pas un resume — ecrivez-le pour le modele ("quand dois-je me declencher ?") Thariq
n'enoncez pas l'evident dans les skills — concentrez-vous sur ce qui pousse Claude hors de son comportement par defaut 🚫👶 Thariq
ne mettez pas Claude sur des rails dans les skills — donnez des objectifs et des contraintes, pas des instructions prescriptives etape par etape 🚫👶 Thariq
incluez des scripts et bibliotheques dans les skills pour que Claude compose plutot que de reconstruire le code repetitif Thariq
integrez !`command` dans SKILL.md pour injecter la sortie dynamique du shell dans le prompt — Claude l'execute a l'invocation et le modele ne voit que le resultat Lydia

Hooks (5)

Astuce Source
utilisez des hooks a la demande dans les skills — /careful bloque les commandes destructrices, /freeze bloque les modifications en dehors d'un repertoire Thariq
mesurez l'utilisation des skills avec un hook PreToolUse pour trouver les skills populaires ou sous-utilises Thariq
utilisez un hook PostToolUse pour auto-formater le code — Claude genere du code bien formate, le hook gere les derniers 10% pour eviter les echecs CI Boris
routez les demandes de permission vers Opus via un hook — laissez-le scanner les attaques et auto-approuver celles qui sont sures 🚫👶 Boris
utilisez un hook Stop pour inciter Claude a continuer ou verifier son travail a la fin d'un tour Boris

Workflows (7)

Astuce Source
evitez la zone morte de l'agent, faites un /compact manuel a 50% maximum. Utilisez /clear pour reinitialiser le contexte en milieu de session si vous changez de tache
Claude Code vanilla est meilleur que n'importe quel workflow pour les petites taches
utilisez /model pour selectionner le modele et le raisonnement, /context pour voir l'utilisation du contexte, /usage pour verifier les limites du plan, /extra-usage pour configurer la facturation supplementaire, /config pour configurer les parametres — utilisez Opus pour le plan mode et Sonnet pour le code pour tirer le meilleur des deux Cat
activez toujours le thinking mode true (pour voir le raisonnement) et le Output Style Explanatory (pour voir la sortie detaillee avec les encadres ★ Insight) dans /config pour mieux comprendre les decisions de Claude Boris
utilisez le mot-cle ultrathink dans les prompts pour un raisonnement a effort eleve
/rename les sessions importantes (ex. [TODO - tache de refactoring]) et /resume les plus tard — etiquetez chaque instance quand vous executez plusieurs Claudes simultanement Cat
utilisez Esc Esc ou /rewind pour annuler quand Claude devie au lieu d'essayer de corriger dans le meme contexte

Workflows avances (6)

Astuce Source
utilisez beaucoup les diagrammes ASCII pour comprendre votre architecture Boris
utilisez /loop pour la surveillance locale recurrente (jusqu'a 3 jours) · utilisez /schedule pour les taches cloud recurrentes qui s'executent meme quand votre machine est eteinte
utilisez le plugin Ralph Wiggum pour les taches autonomes de longue duree Boris
/permissions avec la syntaxe wildcard (Bash(npm run *), Edit(/docs/**)) au lieu de dangerously-skip-permissions Boris
/sandbox pour reduire les demandes de permission avec l'isolation des fichiers et du reseau — 84% de reduction en interne Boris Cat
investissez dans des skills de verification de produit (signup-flow-driver, checkout-verifier) — ca vaut la peine d'y consacrer une semaine pour les perfectionner Thariq

Git / PR (5)

Astuce Source
gardez les PR petites et ciblees — p50 de 118 lignes (141 PR, 45K lignes modifiees en un jour), une fonctionnalite par PR, plus facile a reviser et reverter Boris
toujours squash merge les PR — historique lineaire propre, un commit par fonctionnalite, git revert et git bisect faciles Boris
committez souvent — essayez de committer au moins une fois par heure, des que la tache est terminee Shayan
taguez @claude sur la PR d'un collegue pour generer automatiquement des regles de lint pour les retours de revue recurrents — automatisez-vous hors de la revue de code 🚫👶 Boris Video
utilisez /code-review pour l'analyse multi-agent de PR — detecte les bugs, vulnerabilites de securite et regressions avant le merge Boris

Debugging (7)

Astuce Source
prenez l'habitude de faire des captures d'ecran et de les partager avec Claude chaque fois que vous etes bloque Shayan
utilisez des MCP (Claude in Chrome, Playwright, Chrome DevTools) pour que Claude voie les logs de la console Chrome tout seul
demandez toujours a Claude d'executer le terminal (dont vous voulez voir les logs) en tache de fond pour un meilleur debugging
/doctor pour diagnostiquer les problemes d'installation, d'authentification et de configuration
une erreur pendant la compaction peut etre resolue en utilisant /model pour selectionner un modele a 1M de tokens, puis en executant /compact
utilisez un cross-model pour le QA — par ex. Codex pour la revue de plan et d'implementation
la recherche agentique (glob + grep) bat le RAG — Claude Code a essaye et abandonne les bases de donnees vectorielles car le code derive et les permissions sont complexes Boris Video

Utilitaires (5)

Astuce Source
terminaux iTerm/Ghostty/tmux plutot que l'IDE (VS Code/Cursor) Boris
/voice ou Wispr Flow pour le prompting vocal (productivite x10) Boris
claude-code-hooks pour le feedback de Claude Shayan
status line pour la conscience du contexte et une compaction rapide Boris Shayan
explorez les fonctionnalites de settings.json comme Plans Directory, Spinner Verbs pour une experience personnalisee Boris

Quotidien (2)

Astuce Source
mettez a jour Claude Code quotidiennement Shayan
commencez votre journee en lisant le changelog Shayan

Boris Cherny + Team

Article / Tweet Source
15 fonctionnalites cachees et sous-utilisees dans Claude Code (Boris) | 30/Mar/26 Tweet
Squash Merging et distribution de taille de PR (Boris) | 25/Mar/26 Tweet
Lecons de la construction de Claude Code : comment nous utilisons les Skills (Thariq) | 17/Mar/26 Article
Code Review et Test Time Compute (Boris) | 10/Mar/26 Tweet
/loop — planifier des taches recurrentes jusqu'a 3 jours (Boris) | 07 Mar 2026 Tweet
AskUserQuestion + ASCII Markdowns (Thariq) | 28 Fev 2026 Tweet
Voir comme un Agent - lecons de la construction de Claude Code (Thariq) | 28 Fev 2026 Article
Git Worktrees - 5 facons dont Boris les utilise | 21 Fev 2026 Tweet
Lecons de la construction de Claude Code : le Prompt Caching est tout (Thariq) | 20 Fev 2026 Article
12 facons de personnaliser vos claudes (Boris) | 12/Fev/26 Tweet
10 astuces pour utiliser Claude Code de l'equipe (Boris) | 01/Fev/26 Tweet
Comment j'utilise Claude Code — 13 astuces de ma configuration etonnamment simple (Boris) | 03/Jan/26 Tweet
Demandez a Claude de vous interviewer avec l'outil AskUserQuestion (Thariq) | 28/Dec/25 Tweet
Toujours utiliser le plan mode, donner a Claude un moyen de verifier, utiliser /code-review (Boris) | 27/Dec/25 Tweet

separateur de section

🎬 VIDEOS / PODCASTS

Video / Podcast Source YouTube
Tout ce qu'on a mal fait avec Research-Plan-Implement (Dex) | 24 Mar 2026 | MLOps Community Dex YouTube
Construire Claude Code avec Boris Cherny (Boris) | 04 Mar 2026 | The Pragmatic Engineer Boris YouTube
Responsable de Claude Code : que se passe-t-il apres que le code est resolu (Boris) | 19 Fev 2026 | Lenny's Podcast Boris YouTube
Dans Claude Code avec son createur Boris Cherny (Boris) | 17 Fev 2026 | Y Combinator Boris YouTube
Boris Cherny (createur de Claude Code) sur ce qui a fait progresser sa carriere (Boris) | 15 Dec 2025 | Ryan Peterman Boris YouTube
Les secrets de Claude Code par les ingenieurs qui l'ont construit (Cat) | 29 Oct 2025 | Every Boris YouTube

separateur de section

🔔 S'ABONNER

Source Nom Badge
Reddit r/ClaudeAI, r/ClaudeCode, r/Anthropic Boris + Team
X Claude, Anthropic, Boris, Thariq, Cat, Lydia, Noah, Anthony, Alex, Kenneth Boris + Team
X Jesse Kriss (Superpowers), Affaan Mustafa (ECC), Garry Tan (gstack), Dex Horthy (HumanLayer), Kieran Klaassen (Compound Eng), Tabish Gilani (OpenSpec), Brian McAdams (BMAD), Lex Christopherson (GSD), Dani Avila (CC Templates), Dan Shipper (Every), Andrej Karpathy (AutoResearch), Peter Steinberger (OpenClaw), Sigrid Jin (claw-code), Yeachan Heo (oh-my-claudecode) Community
YouTube Anthropic Boris + Team
YouTube Lenny's Podcast, Y Combinator, The Pragmatic Engineer, Ryan Peterman, Every, MLOps Community Community

separateur de section

☠️ STARTUPS / ENTREPRISES

Claude Remplace
Code Review Greptile, CodeRabbit, Devin Review, OpenDiff, Cursor BugBot
Voice Dictation Wispr Flow, SuperWhisper
Remote Control OpenClaw
Claude in Chrome Playwright MCP, Chrome DevTools MCP
Computer Use OpenAI CUA
Cowork ChatGPT Agent, Perplexity Computer, Manus
Tasks Beads
Plan Mode Agent OS
Skills / Plugins Startups YC de wrappers IA (reddit)

separateur de section

Billion-Dollar Questions

Discutez de ces questions dans les Issues

Memoire et instructions (4)

  1. Que devez-vous exactement mettre dans votre CLAUDE.md — et que devez-vous omettre ?
  2. Si vous avez deja un CLAUDE.md, un fichier separate constitution.md ou rules.md est-il vraiment necessaire ?
  3. A quelle frequence devez-vous mettre a jour votre CLAUDE.md, et comment savoir quand il est devenu obsolete ?
  4. Pourquoi Claude ignore-t-il encore les instructions de CLAUDE.md — meme quand elles disent OBLIGATOIRE en majuscules ? (reddit)

Agents, Skills et Workflows (6)

  1. Quand devez-vous utiliser un command vs un agent vs un skill — et quand Claude Code vanilla est-il simplement meilleur ?
  2. A quelle frequence devez-vous mettre a jour vos agents, commands et workflows a mesure que les modeles s'ameliorent ?
  3. Donner a votre subagent une persona detaillee ameliore-t-il la qualite ? A quoi ressemble un "persona/prompt parfait" pour un subagent de recherche/QA ?
  4. Devriez-vous vous fier au plan mode integre de Claude Code — ou construire votre propre command/agent de planification qui applique le workflow de votre equipe ?
  5. Si vous avez un skill personnel (ex. /implement avec votre style de code), comment integrer les skills communautaires (ex. /simplify) sans conflits — et qui gagne quand ils sont en desaccord ?
  6. Y sommes-nous ? Pouvons-nous convertir un codebase existant en specs, supprimer le code, et faire regenerer par l'IA exactement le meme code a partir de ces specs seules ?

Specs et documentation (3)

  1. Chaque fonctionnalite de votre repo devrait-elle avoir une spec sous forme de fichier markdown ?
  2. A quelle frequence devez-vous mettre a jour les specs pour qu'elles ne deviennent pas obsoletes quand une nouvelle fonctionnalite est implementee ?
  3. Lors de l'implementation d'une nouvelle fonctionnalite, comment gerez-vous l'effet domino sur les specs des autres fonctionnalites ?

separateur de section

RAPPORTS

Agent SDK vs CLI Browser Automation MCP Global vs Project Settings Skills in Monorepos
Agent Memory Advanced Tool Use Usage & Rate Limits Agents vs Commands vs Skills
LLM Degradation

separateur de section

How to Use

1. Lisez le repo comme un cours, apprenez ce que sont les commands, agents, skills et hooks avant d'essayer de les utiliser.
2. Clonez ce repo et experimentez avec les exemples, essayez /weather-orchestrator, ecoutez les sons des hooks, lancez les agent teams, pour voir comment les choses fonctionnent reellement.
3. Allez dans votre propre projet et demandez a Claude de suggerer quelles bonnes pratiques de ce repo vous devriez ajouter, donnez-lui ce repo comme reference pour qu'il sache ce qui est possible.

Regarder sur YouTube

separateur de section

Remerciements

Basé sur shanraisshan/claude-code-best-practice. Merci à Shayan Rais pour sa contribution open source.