site-mariage/.claude/CLAUDE.md

BYAN - Builder of YAN

Projet propulse par BYAN (Merise Agile + TDD + 64 Mantras) Installer: npx create-byan-agent GitHub: https://github.com/Yan-Acadenice/BYAN

Hermes - Dispatcher Universel

Hermes est le point d'entree universel de ton ecosysteme BYAN. Avant de chercher un agent specifique, demande a Hermes. Il connait tous les agents, workflows et contextes, et te route vers le bon specialiste.

Pour invoquer Hermes, tape: @hermes ou demande simplement "quel agent pour [ta tache]?"

Voir @.claude/rules/hermes-dispatcher.md pour les commandes Hermes.

Architecture BYAN

{project-root}/
  _byan/              # Plateforme BYAN
    _config/           # Manifestes (agents, workflows, tasks)
    bmb/               # Module Builder (BYAN, agents, workflows)
    _memory/           # Memoire persistante des agents
    _output/           # Artefacts generes
  .claude/             # Integration Claude Code
    CLAUDE.md          # Ce fichier (instructions projet)
    rules/             # Regles modulaires par domaine
  .github/agents/      # Agents Copilot CLI (si installe)

Regles de Code

• Pas d'emojis dans le code, commits, ou specs techniques (Mantra IA-23)
• Code auto-documente, commentaires uniquement pour le POURQUOI (Mantra IA-24)
• Format commits: type: description (feat, fix, docs, refactor, test, chore)
• Simplicite d'abord - Rasoir d'Ockham (Mantra #37)
• Challenge Before Confirm - Valider avant d'accepter (Mantra IA-16)

Commandes Utiles

• @hermes → Dispatcher universel (recommandations, routage, pipelines)
• Agent disponibles: voir @.claude/rules/byan-agents.md
• Methodologie: voir @.claude/rules/merise-agile.md
• Systeme de confiance epistemique: voir @.claude/rules/elo-trust.md
• Protocol fact-check scientifique: voir @.claude/rules/fact-check.md
• Systeme API byan_web: voir @.claude/rules/byan-api.md

API byan_web

BYAN expose une API REST via $BYAN_API_URL avec authentification par token (ApiKey ou Bearer). 26 tools MCP sont disponibles pour Claude Code — a preferer au curl direct. Voir @.claude/rules/byan-api.md pour le detail.

ELO Trust System

BYAN calibre l'intensite de ses challenges selon votre score ELO par domaine. Score bas → explications pedagogiques et scaffolding. Score eleve → aller droit au but.

Commandes CLI:

• node bin/byan-v2-cli.js elo summary — voir tous les scores par domaine
• node bin/byan-v2-cli.js elo dashboard {domain} — detail d'un domaine
• node bin/byan-v2-cli.js elo declare {domain} {level} — declarer son expertise (junior/mid/senior/lead/expert)

Dans l'agent BYAN, tapez [ELO] pour acceder au menu ELO.

Fact-Check Scientifique

BYAN applique Zero Trust sur lui-meme : tout claim doit etre demonstrable, quantifiable, reproductible. 4 types d'assertions : [REASONING] [HYPOTHESIS] [CLAIM Ln] [FACT USER-VERIFIED] 5 niveaux de preuve : L1 (spec officielle, 95%) → L5 (opinion, 20%) Domaines stricts : security/performance/compliance → LEVEL-2 minimum sinon BLOCKED.

Agent dédié: @fact-checker — analyse assertions, audits de documents, chaines de raisonnement. Dans BYAN: tapez [FC] pour le sous-menu fact-check.

Design Skills Externes (installees dans .claude/skills/)

Quatre skills tierces integrees pour le UI/UX, articulees en pipeline.

Skill	Trigger	Phase
byan-brandkit	"logo / brand kit / identite de marque / palette"	DISCOVERY — planches d'identite
byan-taste-imagegen-web	"mockup visuel / moodboard / image reference de site"	DISCOVERY/BRAINSTORM — visualiser avant de coder
byan-taste	"landing page / portfolio / frontend / refonte UI"	BUILD — generation anti-slop avec dials
impeccable	"critique / audit / polish / a11y" + commandes /impeccable XXX	REVIEW — 23 commandes specialisees

Pipeline design type : byan-brandkit → byan-taste-imagegen-web → byan-taste → /impeccable polish.

Sources : Leonxlnx/taste-skill (MIT) et pbakaus/impeccable (Apache 2.0). Voir SKILL.md de chacune pour les details. Hook fact-check exempte ces paths (contenu importe contient des absolus legitimes type "use OKLCH").