01. Prise en main : partir d'une idée qui tient debout — Bac à sable — développer avec un agent IA

@diagram:lesson-contract
duration :: 10 min lecture
deliverable :: Un brief de projet prêt à donner à un agent
outcome :: Prêt à démarrer le premier projet guidé avec une idée cadrée

Ce que tu dois retenir

Avec les outils IA actuels, tu décris un produit et tu obtiens du code. Praktik ajoute une contrainte avant cette étape : savoir ce que tu veux vérifier. Tant que tu n’as pas ça, l’agent code dans le vide et tu ne peux pas dire si le résultat est bon.

Une bonne idée de départ n’est donc pas « je veux faire une app IA ». C’est aider une personne précise à faire une tâche précise, plus vite ou avec moins d’erreurs :

« Je veux aider une personne précise à faire une tâche précise, plus vite ou avec moins d’erreurs. »

Le fil rouge de ce parcours est un cas francophone : une petite boutique veut préparer plus vite ses fiches produit. L’outil prend quelques infos et génère un brouillon de titre, une description courte et des points clés.

Étape 1 : écris ton idée en une phrase

Une seule phrase, dans ce format :

Je veux aider [profil] à [tâche] pour obtenir [résultat observable].

Deux exemples concrets :

Je veux aider une boutique Shopify à rédiger une fiche produit propre à partir d'un nom, d'un prix et de trois arguments.

Je veux aider un freelance à transformer une note client en brouillon de devis structuré.

Évite les idées trop larges du genre « CRM IA », « assistant business » ou « plateforme de contenu ». Tu ne peux pas les valider vite, donc tu ne sauras pas si tu avances.

Étape 2 : décris le workflow actuel

Avant de demander du code à un agent, décris ce que la personne fait déjà aujourd’hui. Pose-le dans un tableau : à chaque moment, l’action actuelle, le problème, et une preuve que ce problème existe.

Moment	Action actuelle	Problème	Preuve possible
Avant publication	Copier les infos produit	Trop de copier-coller	10 produits prennent 1 h
Rédaction	Inventer titre + description	Ton irrégulier	Retouches fréquentes
Validation	Relire avant mise en ligne	Oublis	Erreurs dans les fiches

Si tu n’as pas de vrai utilisateur sous la main, écris au moins une hypothèse. Tu la corrigeras plus tard, mais tu pars d’une base.

Étape 3 : choisis une seule capacité

Pour le fil rouge, tu gardes une capacité et une seule :

À partir d'un nom de produit, d'un public cible et de trois bénéfices, générer une fiche produit courte en français.

Tout le reste attend. Au début, tu ne fais pas le paiement, les comptes utilisateurs, les analytics, l’import CSV, la génération d’images ni le back-office complet. Tu les notes dans une liste « plus tard ». Ils ne rentrent pas dans le prototype 1.

Étape 4 : définis les critères de réussite

Ton agent coding a besoin de critères vérifiables, sinon il ne peut pas savoir quand il a fini. Écris-les avant de lancer quoi que ce soit :

## Critères de validation
- Je peux saisir un nom de produit.
- Je peux saisir 3 bénéfices.
- Je clique sur "Générer".
- Je vois un titre, une description courte et 5 bullet points.
- Le résultat est en français.
- Je peux copier le résultat.
- L'application démarre en local avec une commande documentée.

Ces critères sont ton garde-fou. Si l’agent part construire un gros SaaS, tu reviens à cette liste et tu le ramènes au périmètre.

Étape 5 : prépare ton brief de départ

Copie ce brief dans ton outil IA :

Je veux créer un petit prototype web local.

Contexte : une petite boutique veut préparer plus vite ses fiches produit en français.

Objectif du prototype : formulaire simple qui prend :
- nom du produit
- public cible
- 3 bénéfices

Résultat attendu : générer un brouillon avec :
- titre produit
- description courte
- 5 bullet points

Contraintes :
- pas d'authentification
- pas de paiement
- pas de base de données au début
- code simple à lancer en local
- interface lisible

Avant de coder, propose-moi :
1. la stack minimale
2. l'arborescence des fichiers
3. les étapes de réalisation
4. les critères de validation

Tu ne demandes pas encore « fais tout ». Tu demandes d’abord le plan.

Check-list de validation

@diagram:checklist
item-1 :: Ton idée tient en une phrase.
item-2 :: Tu sais qui utilise l'outil.
item-3 :: Tu as décrit le workflow actuel.
item-4 :: Tu as choisi une seule capacité.
item-5 :: Tu as 5 à 7 critères de réussite.
item-6 :: Tu as un brief prêt à donner à un agent.

Pièges fréquents

Commencer par l’outil. Cursor, Claude Code ou Codex ne compensent pas un besoin flou.
Tout mettre dans la V1. Une V1 doit apprendre quelque chose, pas impressionner.
Confondre jolie interface et produit utile. Une page moche mais testable vaut mieux qu’une maquette parfaite qui ne fait rien.
Ne pas écrire les critères. Sans critères, tu ne peux pas juger le travail de l’agent.

Suite conseillée

Passe au module 2 pour déléguer sans transformer ton projet en accumulation de prompts improvisés.