Guide Kasparry — Vibe coding sans brûler tes tokens

Méthode pour les vibe coders (Cursor, Claude Code, Codex) : moins de contexte gaspillé, des réponses plus précises, des sessions qui durent.

---

Le problème en une phrase

Chaque message envoie tout le contexte (règles, fichiers, historique) au modèle. Si tu charges 3 000 tokens de règles + 20 fichiers ouverts + 50 messages de chat, tu paies (ou tu plafondes) avant même de poser ta question.

---

Règle #1 — Une tâche = une conversation

❌ Éviter	✅ Faire
Même chat pour 5 features différentes	Nouveau chat / Composer par feature ou bug
« Pendant qu'on y est, change aussi… »	Finir, commit, nouvelle session
Historique de 200 messages	Archiver / repartir avec un résumé court

Pourquoi : l'historique entier est renvoyé à chaque requête. Une session courte = moins de tokens, moins de dérive.

---

Règle #2 — Règles Cursor en .mdc, pas un pavé global

Place tes règles dans .cursor/rules/ en fichiers séparés :

---
description: "Conventions React du projet boutique"
globs: ["src/components/**/*.tsx"]
alwaysApply: false
---

Type	alwaysApply	Quand
Stack + langue + chemins Mac	true	Max 150 mots — le strict minimum
Frontend, tests, SEO, deploy	false + globs	Seulement quand tu touches ces fichiers
Prompts réutilisables	false, pas de glob	@mention manuelle

Taxe token : une règle alwaysApply de 500 mots ≈ 700 tokens à chaque message. Sur 100 messages/jour, c'est 70 000 tokens de pure overhead.

---

Règle #3 — Contexte ciblé avec @

❌  « Lis tout le projet et ajoute un bouton »
✅  « @src/pages/home.html — ajoute un CTA sous le hero, style existant »

Symbole	Usage
@fichier	Une modification précise
@dossier	Refactor limité à un module
@docs/STATE.md	Reprendre où tu en étais sans tout réexpliquer

Ne pas : @Codebase ou « explore le repo » pour une tâche de 3 lignes.

---

Règle #4 — Fichiers d'état courts (STATE.md)

Un fichier ≤ 80 lignes à la racine du projet :

# État du projet
- Dernière action : pagination feed iaoutils
- Prochaine étape : commentaires invités
- Ne pas toucher : iaboutik prod sans backup
- Commandes : npm run dev (port 3002)

Au début de session : @STATE.md + ta demande. Stop de répéter l'histoire du projet.

---

Règle #5 — Prompts compacts (format Kasparry)

Structure en 4 blocs — pas de roman :

OBJECTIF : [1 phrase]
CONTEXTE : @fichier ou 2 lignes max
CONTRAINTES : max 3 bullets (style, ne pas casser X)
DONE QUAND : [critère vérifiable]

Exemple :

OBJECTIF : Bouton S'inscrire en blanc sur fond dégradé
CONTEXTE : @public/css/app.css — classe .topbar-auth .btn-primary
CONTRAINTES : ne pas toucher aux autres pages admin, garder le dégradé
DONE QUAND : texte blanc visible sur iaoutils.com header

---

Règle #6 — Logs projet, pas chat history

Après chaque session significative, 3 lignes dans logs/projet.md :

## 2026-06-11
- Fait : couleur bouton S'inscrire
- Fichiers : app.css, app.min.css
- Suite : modération commentaires

Le chat peut mourir ; le log reste. Prochain agent lit le log, pas 40 écrans de transcript.

---

Règle #7 — Modèle adapté à la tâche

Tâche	Modèle conseillé
CSS, copy, config simple	Rapide / Composer
Refactor multi-fichiers, debug obscure	Modèle reasoning
Explore « comment marche X »	Ask / recherche puis nouvelle session implémentation

Ne pas utiliser le modèle le plus cher pour « change la couleur du bouton ».

---

Règle #8 — Déploiement : une commande documentée

Vibe coders : note la commande exacte de deploy dans STATE.md ou AGENTS.md :

rsync ... && pm2 restart iaoutils

L'agent ne réinvente pas le deploy à chaque fois (= moins d'exploration = moins de tokens).

---

Checklist avant chaque session (30 secondes)

• [ ] Nouveau chat si le sujet change
• [ ] @STATE.md ou @fichier ciblé, pas tout le repo
• [ ] Règles alwaysApply < 150 mots total
• [ ] Prompt en 4 blocs (objectif / contexte / contraintes / done)
• [ ] Modèle adapté à la complexité

---

Checklist fin de session

• [ ] 3 lignes dans le log projet
• [ ] STATE.md mis à jour si le « où on en est » a changé
• [ ] Commit ou note « pas commit — WIP sur branche X »

---

Résumé Kasparry

Moins de contexte automatique, plus de contexte intentionnel.
Tâches courtes, règles scoped, fichiers @ ciblés, état écrit dans des .md — pas dans l'historique du chat.

Partage ce guide aux vibe coders de ton équipe. Commente sur IA Outils si une règle t'a fait économiser des crédits.

---

Guide publié sur IA Outils — communauté francophone IA.