Heliocraft
← Tous les projets

Heliocraft Agent OS

Un pipeline agentique qui part d'une demande dite à voix haute et arrive à du code testé, vérifié et commité, avec un humain qui garde la main aux étapes qui comptent.

StatutPrototype avancé
RôleConception et développement
Période2026 — aujourd'hui

Le problème

Confier un projet entier à un agent de code en autonomie totale ne fonctionne pas : il perd le fil, réécrit ce qui marchait, ou annonce avoir terminé sans l'avoir fait. À l'inverse, piloter l'agent prompt par prompt fait perdre l'essentiel du gain.

Je voulais un système qui reprenne la discipline d'une vraie équipe : une spécification avant le code, un backlog trié, des tests, une revue, et une décision humaine avant tout changement.

Architecture

Chaque demande traverse le même circuit, piloté par un contrat d'état explicite. Une étape qui échoue est retentée une fois, puis la story passe en « bloquée » et je suis notifié.

  1. Entrée vocaleMot de réveil local, transcription sur la machine (faster-whisper).
  2. SpécificationL'agent rédige le besoin et crée la page Confluence correspondante.
  3. Découpage et triLa plateforme de gouvernance IA génère la story Jira et la juge « ai-ready » ou « validation nécessaire ».
  4. Validation humaineRien n'est codé sans confirmation explicite, à la voix ou sur Telegram.
  5. CodageAgent de codage sur une branche et un worktree dédiés, avec le contexte du code fourni par recherche sémantique.
  6. Tests, vérification, sécuritéTrois contrôles successifs ; un verdict « OK, mais… » n'est pas accepté comme un succès.
  7. Commit et notificationCommit local uniquement, puis résumé envoyé sur Telegram.

Garde-fous

  • Jamais de push automatique : la fusion se fait sur ordre explicite.
  • Garde-fou anti-suppression, ajouté après un premier passage qui avait retiré une fonction malgré des tests au vert.
  • File d'attente séquentielle : une seule story en cours de codage à la fois.
  • Commande d'annulation qui archive puis défait le travail d'une story.
  • Journal d'exécution versionné, pour reprendre proprement après un crash.

Stack

  • Python
  • Claude Code (mode headless)
  • LiteLLM
  • Ollama
  • Qdrant
  • faster-whisper
  • openWakeWord
  • Telegram Bot API
  • Confluence
  • Jira
  • GitLab
  • Obsidian (mémoire d'état)

Résultats

  • Une story livrée de bout en bout sans intervention, hors validation, en 7 min 40.
  • 349 tests automatisés sur le pipeline.
  • Routage multi-modèles : modèles locaux pour les tâches simples, modèles cloud pour le jugement et le code.

C'est encore un prototype : il sert de terrain d'essai pour mes propres projets avant d'être proposé à des équipes.

Projet suivant : Plateforme de gouvernance IA