90 lines
4.1 KiB
Markdown
90 lines
4.1 KiB
Markdown
# 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").
|