Bien débuter avec Claude & Claude Code

CLAUDE.md · Queuecraft

# Queuecraft — CLAUDE.md

Dashboard de job queues rendu DANS un monde Minecraft (objet culte fonctionnel,
pas un outil de prod).
Monorepo pnpm : `packages/core` (modèle pivot + interface Adapter),
`packages/adapter-*`, `spikes/*`, `apps/demo`.
Toutes les décisions structurantes sont dans `docs/ADR-001-fondations-queuecraft.md`
— le lire avant tout travail d'architecture. Ne jamais contredire un ADR sans en
écrire un nouveau qui le remplace.

## Commandes
- `pnpm -r typecheck` — typecheck de tous les packages (doit passer avant tout commit)
- `pnpm bench` (dans `spikes/rcon-benchmark`) — benchmark RCON
- Serveur MC jetable : `docker compose up -d` dans `spikes/rcon-benchmark`

## Règles non négociables
1. **Vanilla-stable only** (ADR D4) : uniquement des commandes Minecraft stables
   depuis des années. Toute nouvelle commande → vérifier qu'elle existe telle
   quelle dans les deux versions visées.
2. **Budget RCON** (ADR D7) : ≤ 40 cmd/s en régime de croisière. Diffing
   obligatoire, agrégation obligatoire. Jamais de rendu 1:1 des jobs.
3. **Runtime** (ADR D8) : Node ≥ 22.12, zéro API spécifique Bun. TypeScript strict.
4. **`packages/core` n'importe JAMAIS une techno de queue.** Les adapters
   dépendent de core, jamais l'inverse.
5. **Interface `Adapter` gelée seulement après 2 implémentations.**
6. Sécurité : le port RCON n'est JAMAIS exposé publiquement. Mot de passe via
   variable d'env, jamais en dur.
7. Un seul CLAUDE.md (celui-ci). Pas de CLAUDE.md par sous-dossier.
8. **Zéro entité mobile ou à IA dans le renderer** : uniquement des primitives
   inertes. Animation par `data merge`, jamais par recréation.
9. **Profiling obligatoire avant toute optimisation perf** : on optimise ce qui
   est mesuré, pas ce qu'on suppose.

## Workflow
- Modèle : Opus planifie (plan mode), Sonnet exécute. Quand une carte de roadmap
  commence par un slash command, l'invoquer tel quel en première ligne.
- Après chaque carte : `pnpm -r typecheck`, mettre à jour le README du package
  touché si le comportement public a changé.

.claude/settings.json — base saine

{
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": [
      "Bash(bun test:*)",
      "Bash(bun lint:*)",
      "Bash(git commit:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(git push --force:*)",
      "Bash(rm -rf:*)"
    ],
    "ask": [
      "Bash(git push:*)"
    ]
  }
}