Patterns Claude Code

# Extrait de granit-golem/CLAUDE.md

## Mode de fonctionnement
- ne me demande plus d'autorisation, c'est toujours "yes"
- vérifie bien que la tâche faite est fonctionnelle
- ne fais jamais confiance aux signaux (build OK ≠ fonctionne)
- pour chaque fix, applique un test de confirmation
- pour chaque feature, un test de non-régression

## Workflow Autonome
1. Lire session.md au démarrage
2. Consulter le backlog (tickets P0 en priorité)
3. Implémenter avec TDD (Red → Green → Refactor)
4. Lancer les tests complets
5. Commit avec conventional commits
6. Mettre à jour session.md
7. Passer au ticket suivant

# Extrait de cas-client-multi-agent/CLAUDE.md

## Agents
- **PMO** : Gère specs, priorités, backlog dans .claude/inbox/pmo/
- **Tech** : Implémentation, lit les specs depuis inbox/tech/
- **QA** : Validation, rapports dans .claude/reports/
- **Orchestrateur** : Coordonne via .claude/sync/board.md

## Protocole de communication
- Chaque agent écrit dans son inbox/
- Le board.md est la source de vérité
- Format des messages : YYYY-MM-DD-HH-action.md
- Pas d'appels directs entre agents

# CLAUDE.md - Structure recommandée

## Stack & Environnement
- Langage, framework, versions
- Commandes de build/test/lint
- Ports, URLs, variables d'environnement

## Conventions
- Style de code (formatting, naming)
- Conventional commits obligatoires
- Structure des fichiers

## Règles impératives
- "ne me demande plus d'autorisation"
- "vérifie que la tâche est fonctionnelle"
- "pour chaque fix, un test de confirmation"

## Workflows
- Mode autonome : pick → implement → test → commit
- Mode review : read → analyze → suggest

## Quick Reference
- Commandes fréquentes
- Fichiers importants
- Architecture résumée

# /autopilot - Cycle de maintenance autonome

## Instructions
Tu es en mode autonome. Exécute le workflow suivant en boucle :

1. **Lire** session.md pour connaître l'état courant
2. **Consulter** le backlog : .claude/tickets/ ou issues GitLab
3. **Sélectionner** le ticket P0 le plus prioritaire
4. **Implémenter** en suivant TDD strict :
   - Écrire le test qui échoue (Red)
   - Écrire le code minimal pour passer (Green)
   - Refactorer si nécessaire
5. **Tester** : lancer la suite complète (`cargo test` + `npm test`)
6. **Commiter** : conventional commit, message descriptif
7. **Mettre à jour** session.md avec le travail effectué
8. **Répéter** avec le ticket suivant

## Contraintes
- Ne JAMAIS skipper les tests
- Si un test échoue, le fixer AVANT de continuer
- Commit atomiques (1 commit = 1 changement logique)
- /compact si le contexte dépasse 70%

## Arrêt
- Plus de tickets P0
- Erreur non résolvable
- Contexte à 90%

# /test-sweep - Exécution et rapport de tests

## Instructions
1. Lancer TOUS les tests du projet
2. Analyser les résultats
3. Pour chaque échec :
   - Identifier la cause racine
   - Proposer un fix
   - Appliquer le fix
   - Re-lancer le test ciblé
4. Produire un rapport :

## Format du rapport
```
### Test Sweep Report - {date}
- Total: XX tests
- Passed: XX ✅
- Failed: XX ❌
- Skipped: XX ⏭️
- Coverage: XX%

#### Échecs corrigés
- `test_name`: cause → fix appliqué

#### Échecs non résolus
- `test_name`: cause → action recommandée
```

5. Sauvegarder dans .claude/reports/test-sweep-{date}.md

# /triage - Tri et priorisation des tickets

## Instructions
1. Lire tous les tickets depuis :
   - .claude/tickets/ (fichiers locaux)
   - Issues GitLab (si accès configuré)
2. Classer par priorité :
   - **P0** : Bloquant, sécurité, perte de données
   - **P1** : Bug fonctionnel, régression
   - **P2** : Amélioration, refactoring
   - **P3** : Nice-to-have, cosmétique
3. Estimer la complexité (S/M/L/XL)
4. Mettre à jour session.md avec le backlog trié
5. Recommander les 3 prochains tickets à traiter

# Configuration globale (~/.claude/CLAUDE.md)

## Token Optimization (Global)

### Choix de modèle subagents
- `haiku` (défaut): recherches, explorations, tâches légères
- `sonnet`: analyse de code, review → spécifier `model: "sonnet"`
- `opus`: architecture, décisions complexes → spécifier `model: "opus"`

### Variable d'environnement
CLAUDE_CODE_SUBAGENT_MODEL=haiku    # dans .bashrc / .zshrc

# Exemple de message inter-agents (cas client multi-agent)
# .claude/inbox/tech/2025-01-15-implement-auth.md

## Action requise : Implémenter l'authentification JWT

### Specs (de PMO)
- Endpoint POST /auth/login
- Endpoint POST /auth/refresh
- Guard NestJS pour les routes protégées
- Tests unitaires obligatoires

### Priorité : P0
### Deadline : Sprint 3
### Dépendances : Module User (complété)

### Critères d'acceptation
- [ ] Login retourne un JWT valide
- [ ] Refresh fonctionne avec token expiré
- [ ] Guard rejette les requêtes non authentifiées
- [ ] Coverage > 80% sur le module

# Exemple de dev-story BMAD
# _bmad/backlog/stories/DS-042-filtres-catalogue.md

# DS-042 : Implémenter les filtres du catalogue

## Contexte
L'utilisateur doit pouvoir filtrer les produits par catégorie,
prix et disponibilité.

## Tasks
- [ ] T1: Créer le composable useFilters()
- [ ] T2: Implémenter le composant FilterPanel.vue
- [ ] T3: Connecter à l'API /products?filters=...
- [ ] T4: Tests e2e avec Playwright
- [ ] T5: Review et merge

## Critères de validation
- Filtres persistés dans l'URL (query params)
- Debounce de 300ms sur les inputs
- Skeleton loading pendant le fetch
- Tests e2e sur les 3 types de filtres

# .claude/session.md - Exemple réel (granit-golem)

## État courant
- **Phase** : Sprint 4 - Stabilisation
- **Branche** : feat/outbox-pattern
- **Dernière session** : 2025-01-14 18:30

## Backlog actif
| # | Ticket | Priorité | Status |
|---|--------|----------|--------|
| 1 | Implémenter Outbox Pattern | P0 | ✅ Done |
| 2 | RLS policies pour tenant isolation | P0 | 🔄 In Progress |
| 3 | Migration OpenTelemetry spans | P0 | ⏳ Pending |
| 4 | Fix race condition event handler | P1 | ⏳ Pending |
| 5 | Refactor error types (thiserror) | P2 | ⏳ Pending |

## Décisions récentes
- ADR-007: Outbox Pattern plutôt qu'event sourcing (simplicité)
- ADR-008: RLS au niveau PostgreSQL plutôt qu'applicatif

## Tests
- Dernière exécution : 142 passed, 0 failed, 3 skipped
- Coverage : 78% (cible: 80%)

## Notes
- Le worker outbox a besoin d'un retry avec backoff exponentiel
- Voir si pg_cron peut remplacer le cron Node.js

~/.claude/
├── CLAUDE.md              # Instructions globales (mgrep, tokens, conventions)
├── settings.json          # Permissions globales
└── projects/              # Mémoire persistante par projet
    ├── projet-a/
    │   └── MEMORY.md      # Notes cross-session
    └── projet-b/
        └── MEMORY.md

project/
├── CLAUDE.md                    # Stack, conventions, commandes
└── .claude/
    └── settings.local.json      # Permissions locales

project/
├── CLAUDE.md                    # Instructions, modes, quick reference
└── .claude/
    ├── commands/                # 5-7 commandes personnalisées
    │   ├── autopilot.md         #   Cycle autonome
    │   ├── test-sweep.md        #   Exécution tests
    │   ├── triage.md            #   Tri tickets
    │   ├── review.md            #   Code review structurée
    │   ├── gitlab.md            #   Opérations CI/CD
    │   ├── doc.md               #   Génération documentation
    │   └── sprint-report.md     #   Rapport de sprint
    ├── agents/                  # Définitions d'agents (multi-agent)
    ├── decisions.md             # ADR (Architecture Decision Records)
    ├── session.md               # État courant, contexte de travail
    ├── docs/                    # Stratégie test, migrations, workflows
    │   ├── testing-strategy.md
    │   ├── gitlab-workflow.md
    │   └── product-vision.md
    ├── backlog/                 # BMAD file-based backlog
    │   ├── epics/
    │   └── stories/
    ├── inbox/                   # Communication inter-agents
    │   ├── pmo/
    │   ├── tech/
    │   └── qa/
    ├── reports/                 # Rapports générés (test-sweep, sprint)
    ├── sync/                    # État partagé (board.md)
    └── settings.local.json

// .claude/settings.local.json - Hooks
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\"",
        "description": "Auto-format après chaque écriture"
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo \"[$(date)] Bash: $CLAUDE_TOOL_INPUT\" >> .claude/logs/commands.log",
        "description": "Logger toutes les commandes Bash exécutées"
      }
    ],
    "Stop": [
      {
        "command": "date '+%Y-%m-%d %H:%M' >> .claude/session-timestamps.log",
        "description": "Tracker les fins de session"
      }
    ]
  }
}

# Structure d'un skill (mgrep)
~/.claude/plugins/cache/Mixedbread-Grep/mgrep/
├── skills/
│   └── mgrep/
│       └── skill.md        # Instructions + examples
├── package.json
└── index.js                # CLI executable

# Invocation dans CLAUDE.md
## mgrep - Recherche obligatoire
**CRITIQUE**: Utiliser TOUJOURS `mgrep search` au lieu des outils built-in :
- `mgrep search "query descriptive" chemin/ -m 10 -c -s`
- `mgrep search "query" --web --answer -s`
- Ne JAMAIS utiliser les outils Grep, Glob ou WebSearch

# Structure de la mémoire
~/.claude/projects/
├── projet-a/
│   └── MEMORY.md      # Auto-apprentissage spécifique au projet
├── projet-b/
│   └── MEMORY.md
└── ...

# Règles de gestion (dans CLAUDE.md global)
## Ce qu'il faut sauvegarder :
- Patterns stables confirmés sur plusieurs interactions
- Décisions architecturales importantes
- Préférences utilisateur (workflow, outils, style)
- Solutions à des problèmes récurrents

## Ce qu'il ne faut PAS sauvegarder :
- Contexte de session (tâche en cours, état temporaire)
- Informations non vérifiées
- Ce qui duplique CLAUDE.md

# Exemple : granit-golem - 13 fichiers mémoire
.claude/projects/granit-golem/memory/
├── MEMORY.md                    # Index (5 entrées)
├── user_profile.md              # Préférences du développeur
├── project_overview.md          # Vue d'ensemble architecture
├── project_decisions.md         # ADR persistés cross-session
├── project_infrastructure.md    # Config infra, déploiement
├── project_ci_bugs_2026_03.md   # Bugs CI récurrents à éviter
├── reference_gitlab.md          # URLs, projets, pipelines
├── feedback_e2e_mocking.md      # "Ne jamais mocker /api/v1/xxx/{id}"
├── feedback_testing.md          # "Toujours page objects en E2E"
├── feedback_workflow.md         # "Pas de commit sans validate.sh"
├── feedback_orchestration.md    # "Utiliser session.md, pas les notes"
└── feedback_open_tickets.md     # "Vérifier tickets avant de coder"

# Impact mesuré :
# - Ramp-up : 15 min → 2 min (fichier lu automatiquement)
# - Erreurs récurrentes : -80% (feedback persisté)
# - Cohérence inter-sessions : ++++ (décisions tracées)

# ~/.claude/CLAUDE.md - Section validation

## Validation après modification
- Toujours lancer les vérifications les plus pertinentes après une modification
- Commencer par les vérifications les plus ciblées :
  tests du scope modifié, puis lint, typecheck, build
- Si un test échoue à cause du changement, corriger et re-tester
  avant de demander review
- Ne pas déclarer un travail "terminé" sans indiquer ce qui a été
  exécuté et ce qui ne l'a pas été

## Frameworks par projet (lookup table)
| Projet        | Framework        | Commande                    |
|---------------|------------------|-----------------------------|
| comrenov      | Jest / Vitest    | npm run test:backend/front  |
| basalt-beholder| Vitest + PW     | vitest run / playwright test|
| granit-golem  | Vitest           | vitest run                  |
| sioule-2      | Karma/Jasmine    | npm run front:test          |
| summoner      | Vitest + PW      | npm run test / test:e2e     |