AI Framework / journal-de-construction.md

Journal de construction

Je construis un framework d'agents IA, session par session.

Pas d'équipe de développeurs : un éditeur, un assistant de code, un dépôt GitHub et trois fichiers Markdown. Voici comment je travaille, les outils que j'utilise, et le journal de chaque session, erreurs comprises.

12 sessions ~12 h mesurées 55 commits 98 tests 8 agents
Lire le journal Voir mes outils
CLAUDE.mdCARNET_DE_BORD.mdreporting.md
## Session 6 — Mémoire du projet **Date : 25 septembre 2026** - Fiche consolidée par projet, versionnée, mise à jour après chaque mission. - Piège trouvé en usage réel : la fiche notait « COPIL tenu » alors qu'un agent avait seulement préparé le support. - Règle ajoutée à `prompts/memory/update.md` : un résultat de mission n'est pas un événement du projet. ### Tests pytest tests/ -v → tous verts
Moi ›

Lis le carnet de bord, on reprend là où on s'est arrêtés : la mémoire du projet.

Mon poste de travail

##Huit outils, rien d'exotique

Tout tient sur un ordinateur portable. Les deux premiers font l'essentiel du travail ; les autres servent à vérifier, garder une trace et publier.

VS

VS Code

L'atelier

L'éditeur où j'ouvre le projet : le code, les consignes des agents, les fichiers Markdown, tout est là.

CC

Claude Code

Le binôme

Dans VS Code, je décris en français ce que je veux. Il lit le projet, écrit le code, lance les tests et me dit ce qu'il a vérifié.

.md

Fichiers Markdown

La mémoire

Le contexte du projet et le journal de chaque session, relus au début de la suivante. Sans eux, chaque session repartirait de zéro.

Git

Git et GitHub

L'historique

Chaque étape validée devient un commit, envoyé sur un dépôt privé. On peut toujours revenir en arrière, et je l'ai fait.

CI

GitHub Actions

Le filet

À chaque envoi, les 98 tests automatiques se relancent, sans clé API et sans dépenser un centime d'IA.

◎

Chrome

Le contrôle

Chaque écran est vérifié dans un vrai navigateur. Chrome génère aussi le guide en PDF et les images du site.

API

API Anthropic

Le moteur

Claude Sonnet 5 pour analyser, Claude Haiku 4.5 pour aiguiller les demandes. Chaque appel est mesuré au centime.

www

Hostinger et Systeme.io

La vitrine

Le site est publié par un script en FTP chiffré ; la formation est hébergée sur Systeme.io.

La méthode

##La boucle d'une session

Chaque session suit le même rythme, de 20 minutes à 2 heures. C'est cette régularité, plus que la technique, qui fait avancer le projet.

  1. Relire

    Le carnet de bord, pour savoir exactement où on en est.

  2. Demander

    Une seule chose, en français, avec le « pourquoi ».

  3. Construire

    Claude Code écrit le code et lance les tests.

  4. Vérifier

    Dans Chrome, sur des données fictives, comme un utilisateur.

  5. Noter

    Ce qui a été fait, décidé, et ce qui a raté, dans le carnet.

  6. Enregistrer

    Un commit, un envoi sur GitHub, les tests relancés.

Une règle que je ne contourne pas : rien n'est « prêt » tant que les tests ne sont pas verts et que l'écran n'a pas été vu.

La mémoire du projet

##Trois fichiers Markdown qui tiennent tout

Un assistant de code oublie tout d'une session à l'autre. Ces trois fichiers lui redonnent le contexte, et me servent autant qu'à lui.

AI_Project_Framework.md la vision

Le document de référence

29 sections écrites avant la première ligne de code : la vision, l'architecture cible, le produit minimal, la feuille de route en 12 phases. Il n'est jamais réécrit de mémoire : on le relit avant chaque décision de structure.

CLAUDE.md le contexte

Le contexte, chargé à chaque session

Ce qu'est le projet, ce qui est fait, les principes à ne jamais contourner (projets étanches, rien d'inventé), les conventions de travail. Claude Code le lit automatiquement en ouvrant le dossier.

CARNET_DE_BORD.md le journal

Le journal de bord

Une entrée par session : ce qui a été construit, les décisions, les pièges, la durée réelle. Près de 600 lignes aujourd'hui. C'est la source de cette page.

Le journal

##Douze sessions, du socle au site

Extraits du carnet de bord, réécrits pour être lus. Les durées sont celles que j'ai notées ; quand je ne l'ai pas fait, je le dis.

SESSION 0117 septembre 202645 mind487e9c

Le socle et un premier agent

Construit
  • Des consignes en trois couches : règles communes, rôle, tâche
  • Un agent chef de projet : résumer une réunion, analyser les risques, préparer un COPIL
  • Les projets étanches, les documents rangés par nature
app/core/prompts.pyprompts/
Outils
VS CodeClaude CodeGit et GitHubclaude.ai

Premier commit, dépôt GitHub privé, et une maquette de l'interface dessinée dans claude.ai.

Ce que j'ai appris

Une maquette hébergée dans claude.ai ne peut appeler aucun service extérieur. Le vrai tableau de bord devait donc être servi par l'application elle-même.

SESSION 0222 septembre 202620 min

Un tableau de bord branché sur les vraies données

Construit
  • La liste des projets, leurs documents, le formulaire de mission, l'historique
  • Un projet de démonstration fictif, « Aurora »
dashboard/index.html
Outils
Claude CodeChrome

Premier test de bout en bout dans un vrai navigateur.

Ce que j'ai appris

Tester d'abord sans clé API : la mission échoue, mais l'erreur s'affiche clairement dans la page au lieu de tout bloquer.

SESSION 0323 septembre 202680 min

Deux agents de plus, sans toucher au cœur

Construit
  • Un agent réalisation et un agent exploitation
  • La carte des agents : qui a travaillé sur quel projet
app/agents/registry.py
Outils
Claude CodeConsole Anthropic

Préparation d'un espace de travail dédié à la clé API, avec un plafond de dépense.

Ce que j'ai appris

La clé API n'a rien à voir avec l'abonnement Claude ou Claude Code : trois accès indépendants, facturés séparément.

SESSION 0423 septembre 2026, le soir120 min

Premiers vrais appels, chiffres et coûts

Construit
  • Des indicateurs chiffrés à la fin de chaque réponse
  • Le suivi de la consommation, converti en dollars
  • Le contrôle des combinaisons agent et tâche
app/core/security.py
Outils
API AnthropicClaude CodeChrome

Le premier appel réel respecte la règle : rien d'inventé.

Erreur corrigée

La consigne d'indicateurs n'était pas toujours suivie. Une section dédiée, avec un exemple, a réglé le problème.

SESSION 0524 septembre 2026120 min

L'orchestrateur multi-agents

Construit
  • Une demande en français devient un plan de 1 à 4 étapes
  • Les agents travaillent en parallèle, une synthèse croise leurs résultats
  • Trois agents et une synthèse : environ 70 secondes et 15 centimes
app/core/orchestrator.py
Outils
Claude Haiku 4.5Claude Sonnet 5Claude Code

Un modèle léger pour aiguiller, un modèle puissant pour analyser.

Erreur corrigée

Des réponses vides : le modèle commençait par réfléchir, et le code ne lisait que le premier bloc de sa réponse.

SESSION 0625 septembre 2026120 min

La mémoire du projet

Construit
  • Une fiche par projet, sourcée et versionnée
  • Mise à jour automatiquement après chaque mission, transmise aux suivantes
app/core/project_memory.pyprompts/memory/update.md
Outils
Claude CodeChrome

Deux défauts de la consigne trouvés en usage réel, et corrigés le jour même.

Erreur corrigée

La mémoire notait « COPIL tenu » alors qu'un agent avait seulement préparé le support. Un document produit n'est pas un événement.

SESSION 0726 septembre 2026120 mind196873

De vrais documents, et un filet de sécurité

Construit
  • Lecture des PDF, Word et Excel, dépôt par glisser-déposer
  • Les missions tournent en arrière-plan : la page répond en 0,12 seconde au lieu de 30 à 40
  • Les tests relancés automatiquement à chaque envoi
.github/workflows/tests.yml
Outils
GitHub ActionsClaude CodeChrome

Premier passage de GitHub Actions au vert sur ce commit.

Ce que j'ai appris

Refuser proprement un PDF scanné vaut mieux que le transmettre vide à un agent.

SESSION 0828 septembre 2026durée non notée

Des supports pour présenter le projet

Construit
  • Une présentation et une première page de présentation
  • Six captures d'écran réelles, sur le projet fictif
Outils
Chromeclaude.ai

Les captures sont prises dans Chrome, sur des données inventées pour les tests.

SESSION 0928 septembre 2026durée non notée

Mesurer avant d'optimiser

Construit
  • Le lancement direct d'un plan, sans validation
  • La mémoire 35 % moins chère, après un banc d'essai de quatre réglages
  • Un guide d'utilisation, et son PDF
dashboard/guide/index.html
Outils
API AnthropicChrome

Le PDF du guide est généré par Chrome à partir de la page.

Réglages écartés

Les deux options les moins chères inventaient une mise en production qui n'avait jamais eu lieu.

SESSION 1028 septembre 2026durée non notée

Couvrir tout le cycle de vie d'un projet

Construit
  • Quatre agents : avant-vente, commercial, budget, retours d'expérience
  • Une bibliothèque de retours d'expérience anonymisés, validés par un humain
app/core/retex.py
Outils
Claude CodeChrome

Environ 50 centimes de tests réels pour valider les quatre agents.

Ce que j'ai appris

Le vocabulaire compte : « directive » est devenu « mission », un mot que tout le monde comprend.

SESSION 1129 septembre 202690 min

Le site, la formation, un agent pour les itérations

Construit
  • Les huit modules de la formation, en Markdown dans le dépôt
  • Le site en ligne, publié par un script
  • Un huitième agent pour les itérations
docs/formation/scripts/deploy_site.py
Outils
HostingerSysteme.ioGitHub

16 commits dans la journée, le record du projet.

Erreur corrigée

L'API publique de Systeme.io refusait tout contenu. Solution : passer par l'éditeur, depuis une session ouverte dans le navigateur.

SESSION 1230 septembre 2026en cours

Rendre le framework générique

Construit
  • Des agents aux noms génériques : Cap, Relais, Pilote, Forge, Balance, Vigie, Cadence, Sillage
  • Une section sur le paramétrage : prompts et compétences
Outils
Claude CodeGitChrome

Une version simplifiée du site, puis un retour arrière en un commit.

Ce que j'ai appris

Simplifier n'est utile que si l'essentiel reste. Git permet d'essayer sans risque.

Apprendre

Refaire ce parcours, pour votre métier

La formation suit exactement ces sessions, dans l'ordre, avec un projet qui grandit à chaque module.

Voir la formation

Voir le résultat

Naviguez dans Framework

L'application construite au fil de ces sessions, sur deux projets fictifs, sans compte.

Ouvrir l'application