nakama — Augmented Craft

Nous travaillons tous les jours avec Claude Code depuis sa sortie. D'abord pour augmenter notre propre productivité et efficacité — maintenant nous l'appliquons chez nos clients. Cette cheatsheet, c'est ce qu'on aurait voulu avoir le premier jour.

Démarrer : /init puis affiner

Installation : curl -fsSL https://claude.ai/install.sh | bash (Node 18+ requis). cd dans le projet, lancer claude, puis /init — Claude scanne le repo et crée un CLAUDE.md de départ. C'est le point d'entrée. À toi de l'affiner.

CLAUDE.md, la mémoire persistante

CLAUDE.md = la mémoire que Claude charge au début de chaque session. Trois angles à couvrir :

— WHAT : la stack tech, le file map, l'architecture

— WHY : pourquoi chaque module existe, les décisions de design

— HOW : les commandes build/test/lint, les workflows, les gotchas

Court, dense, pas de remplissage. Si Claude ne peut pas deviner une convention, inscris-la.

La hiérarchie mémoire

Quatre niveaux, du plus large au plus fin :

1~/.claude/CLAUDE.md      → global, tous projets confondus
2~/CLAUDE.md              → racine monorepo
3./CLAUDE.md              → projet, partagé sur Git
4./frontend/CLAUDE.md     → sous-dossier, contexte scoped

Règles : moins de 200 lignes par fichier, les sub-folders append (jamais override) le parent. Le CLAUDE.md projet est versionné — c'est une convention d'équipe, pas un fichier perso.

Skills, le superpouvoir

Les Skills sont des guides markdown que Claude auto-invoque quand le langage naturel correspond à leur description. Deux scopes :

— Project : .claude/skills/<name>/SKILL.md

— Personal : ~/.claude/skills/<name>/SKILL.md

Le champ description du frontmatter est critique — c'est ce qui déclenche l'auto-activation. Mauvaise description = skill jamais utilisé.

Exemples qu'on a en interne : code-review, testing-patterns, commit-messages, api-design, deployment-checklist. Les skills sont aussi de la doc vivante de vos pratiques.

Hooks, les garde-fous

Les Hooks sont des callbacks déterministes (vs l'IA, non-déterministe). Trois types : PreToolUse, PostToolUse, Notification.

1{
2  "hooks": {
3    "PreToolUse": [{
4      "matcher": "Bash",
5      "hooks": [{
6        "type": "command",
7        "command": "scripts/sec.sh",
8        "timeout": 5
9      }]
10    }]
11  }
12}

Codes de sortie : 0 autorise, 2 bloque. Idéal pour scanner les commandes Bash avant exécution, déclencher des linters, notifier sur Slack.

Agents, contexte isolé

Les sub-agents tournent dans leur propre contexte — ne polluent pas la session principale. Stockés dans .claude/agents/<name>.md. À utiliser pour : code review profond, audit sécurité, génération de tests, recherche doc. Chaque agent a son prompt système et son périmètre.

Permissions et sécurité

Allowlist / denylist :

1{
2  "permissions": {
3    "allow": ["Read:*", "Bash:git:*", "Write:*:*.md"],
4    "deny": ["Read:env:*", "Bash:sudo:*"]
5  }
6}

Pour les contextes pro réels, c'est non-négociable. Souveraineté, données sensibles, traçabilité — sans ça, on reste dans le jouet.

Le workflow quotidien

1cd project && claude
2Shift + Tab + Tab → Plan Mode    # planifier avant d'agir
3Describe feature intent
4Shift + Tab → Auto Accept         # laisser tourner
5/compact                          # compresser le contexte
6Esc Esc → rewind                  # revenir en arrière
7Commit frequently
8Start new session per feature     # 1 feature = 1 session

Le pattern qui marche : Plan Mode d'abord (Claude pose le plan, on l'amende), puis exécution. /compact régulier pour ne pas saturer le contexte. Commit après chaque étape. Une session = une feature.

L'architecture en 4 couches

Quatre couches qui se composent :

— L1 — CLAUDE.md : contexte persistant et règles

— L2 — Skills : packs de connaissance auto-invoqués

— L3 — Hooks : garde-fous et automatisation

— L4 — Agents : sub-agents avec contexte isolé

C'est cette composition qui transforme Claude Code d'un assistant en un vrai outil de production.

Quick reference

— /init — génère le CLAUDE.md

— /compact — compresse le contexte

— Shift + Tab — change de mode

— Tab — toggle extended thinking

— Esc Esc — menu rewind

Notre prise

Claude Code, ce n'est pas un outil isolé — c'est presque un écosystème : un ensemble d'outils, de conventions et une manière de travailler. Comme tout écosystème, il a une courbe d'apprentissage : la majorité des devs qui le posent une heure n'en tirent pas le quart de sa valeur.

C'est exactement ce qu'on transmet en formation — pas du prompting basique, mais l'architecture en 4 couches, les conventions d'équipe, les garde-fous. Maîtriser l'outil au lieu de le subir.

Crédit cheatsheet originale : Brij Kishore Pandey.

Claude Code en pratique - les fondamentaux