BYAN v2.7.0 — Build Your AI Network

Créateur intelligent d'agents IA | Merise Agile + TDD + 71 Mantras

Documentation en anglais disponible ici : README-EN.md

---

Bonjour

Bonjour à tous ! J'ai l'honneur de vous présenter BYAN, votre ami sur vos projets — que vous soyez développeur, vibe codeur ou juste curieux.

Important : Je précise que c'est un projet pas fini et plus un MVP/note d'intention qu'une vraie version finale en production. C'est un outil en évolution active, et c'est précisément là où réside son intérêt.

Pourquoi BYAN existe

Pour comprendre le contexte de BYAN, il faut comprendre pourquoi j'ai décidé de le créer. La problématique de base est simple.

Je me suis retrouvé avec un gros projet sur les bras, des deadlines très serrées, pas de budget, et une équipe inexpérimentée pour le faire. Ce qui m'a amené à faire des crunchs stupides avec des développeurs en dépression.

Pour résoudre ce problème, m'est venue l'idée d'utiliser les agents IA pour accélérer le développement du projet. Grâce à un de mes étudiants en dev (crédité dans les contributeurs du projet) à qui je donne cours, j'ai découvert la méthode BMAD, qui est un framework d'agents IA. Au départ sceptique, j'ai été bluffé du résultat, bien que ces agents IA souffraient des biais habituels des IA, en particulier en fonction du modèle utilisé et de qui l'utilise et comment.

Alors une idée simple est venue : et si on pouvait mettre un cadre à tous ces agents pour y apporter de "l'intelligence", peu importe le projet, en mettant des règles et contraintes de base pour contrer les biais des modèles d'IA ?

C'est là que m'est venue l'idée de leur insuffler des mantras — des règles absolues auxquelles l'agent devait se conformer. Des gardes-fous épistémiques, méthodologiques et comportementaux qui transforment un LLM bavard en partenaire fiable.

Maintenant, la problématique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et règles ?

Il suffit de les instaurer à la source, c'est-à-dire à la création des agents. C'est là que BYAN intervient : il va vous assister dans la création intelligente d'agents IA.

Ce que BYAN n'est pas

Par contre, attention : BYAN n'est pas magique. Le but est de pousser le "homme-machine" pour faire des agents IA une extension de votre cerveau. Donc BYAN va vous challenger, éprouver votre problème et votre solution — mais mal utilisé, il ne résoudra pas vos problèmes comme par magie.

C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la réalisation de vos projets.

---

Anatomie d'un agent BYAN

Un agent BYAN n'est pas un script. C'est une chaine vivante de couches doctrinales, et il appartient a une equipe.

flowchart LR
  subgraph Agent["Un agent BYAN"]
    Soul["Soul<br/>identite"]
    Tao["Tao<br/>voix"]
    Valeurs["Valeurs<br/>lignes rouges, convictions"]
    Mantras["Mantras<br/>regles d'action"]
    Comportement["Comportement"]
    Soul --> Tao --> Valeurs --> Mantras --> Comportement
  end

  Agent -. appartient a .-> Equipe["Equipe BYAN<br/>N agents complementaires<br/>orchestres par Hermes"]

Diversifier les personas elargit la surface de competence collective.

---

Installation

Prérequis

• Node.js >= 12.0.0
• npm >= 6.0.0
• Un compte Claude Code ou Codex (selon la plateforme cible)

Installation rapide (recommandée)

Aucune installation préalable n'est nécessaire. Lancez simplement :

# Assistant d'installation graphique dans le navigateur (par défaut)
npx create-byan-agent

# Ou installation globale
npm install -g create-byan-agent
create-byan-agent

Par défaut, create-byan-agent ouvre l'assistant graphique. S'il détecte l'app Desktop BYAN installée, il l'ouvre dans une fenêtre native ; sinon il démarre un petit serveur local (lié à 127.0.0.1) et ouvre la page d'installation dans le navigateur. Dans les deux cas c'est le même assistant : vous y choisissez le nom du projet, le répertoire et les options.

Modes selon vos besoins :

En mode --cli, si des copies globales de skills sous ~/.claude/skills divergent de l'installation, l'assistant le signale et affiche la commande de synchronisation — sans bloquer et sans rien écrire dans votre home. Ajoutez --sync-skills pour qu'il les synchronise directement.

Détection de l'app Desktop : emplacements d'installation standards par système (/opt/BYAN/byan et /usr/bin/byan sous Linux, BYAN.app sous macOS, BYAN.exe sous Windows). Pour une AppImage ou un chemin personnalisé, pointez la variable BYAN_DESKTOP_BIN sur l'exécutable. Tant que l'app Desktop n'est pas installée, l'assistant s'ouvre dans le navigateur — aucun blocage.

Structure du projet après installation

À la fin de l'installation, votre projet contient :

votre-projet/
  _byan/               # Plateforme BYAN — cœur du système
    _config/           # Manifestes des agents et workflows
    _memory/           # Mémoire persistante (ELO, fact-graph, session-state)
    agents/            # Agents disponibles (core, bmm, bmb, cis, tea)
    workflows/         # Workflows guidés
    knowledge/         # Base de connaissances sources (axiomes, benchmarks)
    config.yaml        # Configuration principale (langue, utilisateur, chemins)
  .claude/             # Intégration Claude Code (si activée)
  .codex/              # Intégration Codex/OpenCode (si activée)
  bin/byan-v2-cli.js   # CLI BYAN

Commandes CLI disponibles

Une fois installé, vous pouvez utiliser le CLI BYAN :

# Lancer l'interview intelligente (crée un agent en 12 questions)
node bin/byan-v2-cli.js create

# Vérifier l'état de la session
node bin/byan-v2-cli.js status

# Système ELO — score de confiance par domaine technique
node bin/byan-v2-cli.js elo summary
node bin/byan-v2-cli.js elo context security
node bin/byan-v2-cli.js elo record javascript VALIDATED

# Fact-check scientifique — vérifier une assertion
node bin/byan-v2-cli.js fc check "Redis est toujours plus rapide que PostgreSQL"
node bin/byan-v2-cli.js fc parse "C'est évidemment la meilleure approche"
node bin/byan-v2-cli.js fc graph

Utilisation programmatique (via npm)

const ByanV2 = require('create-byan-agent');

const byan = new ByanV2({ maxQuestions: 12 });
await byan.startSession();

// Interview guidée
while (!byan.isComplete()) {
  const question = byan.getNextQuestion();
  const answer = await getUserInput(question.text);
  await byan.submitResponse(answer);
}

// Générer le profil d'agent
const profile = await byan.generateProfile();
console.log('Agent créé :', profile.filePath);

// Fact-check
const result = byan.checkClaim("Redis est plus rapide");
console.log(result.assertionType, result.score + '%');

// Score ELO
const ctx = byan.getClaimContext('security');
console.log('Scaffold level :', ctx.scaffoldLevel);

Activer les agents dans Claude Code ou Codex

Une fois installé, les agents sont disponibles via @agent-name :

@hermes            # Dispatcher universel — recommande le bon agent
@byan              # Créateur d'agents (interview intelligente)
@analyst           # Analyste business (Mary)
@architect         # Architecte technique (Winston)
@pm                # Product Manager (John)
@dev               # Développeur (Amelia)
@fact-checker      # Fact-check scientifique
# ... et 30+ autres agents

---

Liste des Agents Disponibles

BYAN contient 26 agents spécialisés organisés en 5 modules :

Core — Fondation de la Plateforme

BMB — Créateurs d'Agents et de Modules

BMM — Cycle de Développement Logiciel

CIS — Innovation et Stratégie Créative

TEA — Architecture de Tests

---

Contributeurs

Créateur et Lead Developer

Yan-Acadenice — Conception, architecture, développement de BYAN

Contributeur Principal — Agent Hermes

Wazadriano — Agent Hermes, Dispatcher Universel (v2.3.2)

• Architecture et conception du dispatcher universel Hermes
• Règles de routage intelligent et pipelines multi-agents
• Intégration complète avec l'écosystème BYAN

Remerciements

BYAN est construit au-dessus de la méthode BMAD, découverte grâce à un étudiant de la formation Acadenice à qui je donne cours.

---

Explication de l'Architecture BYAN — Workflow/Context/Agent/Worker (WCAW)

BYAN est organisé autour de quatre concepts fondamentaux qui interagissent ensemble :

Agent

Un agent est un spécialiste IA avec une identité définie. Il possède :

• Persona : qui il est, son style de communication, ses forces
• Menu : les actions disponibles, chacune liée à un workflow ou une commande
• Rules : les contraintes absolues qu'il ne peut pas violer (les 71 mantras)
• Capabilities : ce qu'il peut faire, ce qu'il ne fait pas

Les agents sont définis en Markdown avec des sections XML. Ils sont stockés dans _byan/{module}/agents/ et exposés sur chaque plateforme via un wrapper léger (.claude/, .codex/prompts/).

Workflow

Un workflow est une séquence d'étapes guidées qu'un agent exécute pour accomplir une tâche complexe. Par exemple, le workflow create-prd guide l'agent PM à travers la création d'un Product Requirements Document en 6 étapes structurées.

Les workflows peuvent être :

• Tri-modaux : Create / Validate / Edit (ex: PRD, Architecture)
• Séquentiels : processus multi-phases guidés (ex: interview BYAN en 4 phases)
• Utilitaires : tâches ponctuelles (ex: fact-check, shard-doc)

Context Layer

Le contexte est la couche de mémoire et d'état partagée entre tous les agents sur un projet. Il contient :

• _byan/config.yaml : configuration globale (langue, nom utilisateur, chemins de sortie)
• _byan/_memory/elo-profile.json : score de confiance ELO persistant par domaine
• _byan/_memory/fact-graph.json : base de connaissances vérifiées (persiste entre sessions)
• _byan-output/ : tous les artefacts générés (PRD, architecture, stories, fact sheets)
• _byan/knowledge/ : sources vérifiées, axiomes, benchmarks ELO par domaine

Worker

Un worker est un module utilitaire npm-installable qui fait un travail spécifique en arrière-plan. Il est indépendant du cycle agent/workflow et peut être utilisé directement dans votre code.

Workers disponibles :

• _byan/workers/fact-check-worker.js : vérification scientifique de claims
• _byan/workers/cost-optimizer.js : routage LLM intelligent (~54% d'économies)

const FactCheckWorker = require('./_byan/workers/fact-check-worker');
const fc = new FactCheckWorker({ verbose: true });

// Vérifier un claim
fc.check("Redis est toujours plus rapide que PostgreSQL");
// → { assertionType: 'HYPOTHESIS', level: 5, score: 20, status: 'OPINION' }

// Détecter les claims implicites dans un texte
fc.parse("C'est évidemment la meilleure approche pour la sécurité");
// → [{ matched: 'évidemment', position: 5, ... }]

---

Schéma de Fonctionnement — Architecture WCAW

Le diagramme conceptuel ci-dessous montre comment les quatre composants interagissent. Hermes est le point d'entrée universel : il reçoit votre requête et la route vers le bon agent.

VOUS  →  @hermes "je veux créer un agent"
              │
              ▼
    ┌─────────────────────────────────────────────────────────┐
    │                  AGENT (spécialiste IA)                  │
    │    Persona · Menu · Rules (71 mantras) · Capabilities    │
    └────────────┬─────────────────────────┬───────────────────┘
                 │ déclenche               │ appelle
                 ▼                         ▼
    ┌────────────────────┐    ┌─────────────────────────────┐
    │     WORKFLOW       │    │          WORKER              │
    │  Steps guidés      │    │  ELO Engine                 │
    │  Artifacts générés │    │  Fact-Checker               │
    │  Validation steps  │    │  Cost Optimizer             │
    └────────┬───────────┘    └─────────────┬───────────────┘
             │ lit/écrit                    │ persiste
             ▼                              ▼
    ┌─────────────────────────────────────────────────────────┐
    │                    CONTEXT LAYER                         │
    │  config.yaml · elo-profile.json · fact-graph.json        │
    │  _byan-output/ · _byan/knowledge/ · session-state        │
    └─────────────────────────────────────────────────────────┘

Diagrammes interactifs draw.io

Pour une visualisation plus détaillée, ouvrez ces fichiers avec draw.io :

• Architecture globale BYAN : byan-architecture.drawio
• Concept Workflow/Context/Agent/Worker : byan-wcaw-concept.drawio

---

Systeme Soul & Voice — Des Agents avec une Conscience

BYAN v2.7.0 introduit le Soul System et le Tao System : chaque agent peut porter une ame (valeurs, personnalite, gardes-fous) et une voix unique (signatures verbales, ton, tics de langage).

Le Soul — Identite Abstraite

L'ame est ce qui fait d'un agent plus qu'un executant. Elle porte vos valeurs, vos gardes-fous, votre phrase fondatrice. Elle repond a la question : qui est cet agent, et qu'est-ce qu'il defend ?

Le Tao — De l'Abstrait au Concret

Le Tao est le pont entre le spirituel et le tangible. Il prend l'ame abstraite — valeurs, croyances, principes — et la transforme en matiere : une voix, des tics verbaux, des mots interdits, des changements de temperature, des patterns de parole concrets. Le Tao est ce qui insuffle la vie a un agent. Sans lui, l'ame reste une idee. Avec lui, l'agent parle, reagit et existe.

Le nom est un hommage personnel. Le concept reflete le sens originel : la voie, le chemin entre ce que quelque chose est et comment il se manifeste.

Installation

Lors de l'installation, vous choisissez votre mode soul :

Fichiers cles :

• _byan/creator-soul.md — Vos valeurs et verites fondamentales (immuable)
• _byan/soul.md — La personnalite de BYAN derivee de la votre
• _byan/tao.md — Directives vocales (signatures verbales, mots interdits, carte des temperatures)
• _byan/soul-memory.md — Journal vivant qui grandit avec l'usage

Construisez votre ame interactivement :

@byan    # Puis demandez le workflow Forge
@tao     # Puis utilisez [FORGE-VOICE] pour construire votre voix

Documentation complete : SOUL-SETUP-GUIDE.md

---

Système ELO — Confiance Épistémique

BYAN v2.6.0 introduit un système de calibration de la confiance par domaine technique (algorithme Glicko-2, échelle 0-1000).

Principe : un score bas ne punit pas — il augmente la pédagogie. BYAN s'adapte à votre niveau réel, pas à celui que vous déclarez.

---

Fact-Check Scientifique

BYAN applique Zero Trust sur lui-même : tout claim doit être démontrable, quantifiable, reproductible.

[REASONING]              Déduction logique — sans garantie de vérité
[HYPOTHESIS]             Plausible dans ce contexte — à vérifier avant action
[CLAIM L{n}]             Assertion sourcée — niveau 1 à 5
[FACT USER-VERIFIED date] Validé par l'utilisateur avec artefact de preuve

Domaines stricts : security / performance / compliance → LEVEL-2 minimum ou BLOCKED.

---

BYAN Strict Mode — Anti-Downgrade

Mode d'enforcement qui empêche l'agent de livrer moins que demandé (un MVP au lieu de l'app prod, un stub au lieu de la feature, un template baclé). Actif sur les 2 plateformes : Claude Code, Codex.

1. Lock du scope       byan_strict_lock_scope  (scope verbatim + critères testables)
2. Build complet       pas de MVP, pas de stub, tout gap est signalé
3. Self-verify >= 3x   byan_strict_self_verify (relit la demande initiale)
4. Complete            byan_strict_complete    (jeton d'audit)

Le commit est bloqué par un filet pre-commit tant que la session strict engagée n'est pas complétée correctement — y compris pour Codex qui n'a pas de hook in-session. Source de vérité unique : _byan/_config/strict-mode.yaml, régénérée via byan-sync-rules.

Activation : byan_fd_start strict:true, skill byan-strict, ou auto-détection sur mots-clés (prod, client, livrable, contrat, release...).

---

Workflows Principaux

---

Plateformes Supportées

---

Licence

MIT © Yan-Acadenice

---

Fait avec de la frustration, de la curiosité, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.