Build pack : coder Vivra avec Claude Code

Les autres parties de ce GitBook disent quoi construire. Cette partie dit comment le faire construire par Claude Code, ticket par ticket, avec des critères de fin vérifiables par commande.

Les pages pour l'IA (CLAUDE.md, conventions, tickets) sont en anglais : c'est la langue du code, et ça évite les ambiguïtés entre le texte et les noms de fichiers ou de fonctions. Le reste de la doc reste en français et fait foi pour les règles produit.

Ce que contient le pack#

Chaque ticket a le même format :

• Goal : le résultat en une phrase.
• Depends on : les tickets à finir avant.
• Read first : les pages de la spec à lire avant de coder.
• Build : les fichiers à créer ou modifier.
• Steps : les étapes dans l'ordre, avec les interfaces exactes.
• Done when : la liste de contrôle, chaque point vérifiable par une commande ou un test.
• Out of scope : ce qu'il ne faut pas faire dans ce ticket.

Mise en place (une fois)#

1. Créer le repo du code vivra (privé), et cloner les deux repos côte à côte :
   bashCopier

   mkdir vivra-workspace && cd vivra-workspace
   git clone git@github.com:sonnyHQ/vivra-doc.git
   git clone git@github.com:<org>/vivra.git

2. Copier CLAUDE.template.md dans vivra/CLAUDE.md et le commiter.
3. Créer vivra/.env à partir de .env.example (ticket T00) avec les clés de l'annexe F. Jamais commité.
4. Lancer Claude Code dans vivra/ : claude.

La boucle de travail (pour chaque ticket)#

1. Ouvrir une session Claude Code dans vivra/ et lui donner ce prompt, en changeant le numéro :

   textCopier

   Implement ticket T14 from ../vivra-doc/build-m1.md.
   Read the ticket and every page listed in "Read first" before writing code.
   Start by writing your plan (files, functions, tests). Then implement it,
   run the "Done when" checks, and open a PR named "T14: <title>" with the checklist ticked.
   If anything in the spec is unclear or contradictory, stop and ask me.

2. Relire le plan avant qu'il code. C'est là qu'on rattrape 90 % des erreurs.

3. Quand Claude a fini : relancer soi-même pnpm lint && pnpm typecheck && pnpm test et les vérifications du ticket.

4. Relire la PR, merger, passer au ticket suivant.

Règles simples qui évitent les dérapages :

• Un ticket par session. Une nouvelle session pour chaque ticket garde le contexte propre.
• L'ordre compte. Les tickets d'un jalon dépendent souvent des précédents (champ « Depends on »).
• Les tickets marqués 🔒 touchent à l'argent ou aux clés. Relecture humaine ligne par ligne, et tests sur testnet avant tout merge.
• Les tickets marqués ⚠️ Pons dépendent d'une ABI ou d'une réponse de Pons pas encore confirmée (questions ouvertes). Claude doit s'arrêter sur ces points et demander.

Jalons et portes de sortie#