create-byan-agent 2.7.0 → 2.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +151 -207
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,298 +1,242 @@
1
- # BYAN - Intelligent AI Agent Creator
1
+ # BYAN v2.7.0 — Build Your AI Network
2
2
 
3
- **Create custom AI agents in 15 minutes** | GitHub Copilot CLI, VSCode, Claude Code
3
+ [![npm](https://img.shields.io/npm/v/create-byan-agent.svg)](https://www.npmjs.com/package/create-byan-agent)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+ [![Node](https://img.shields.io/badge/node-%3E%3D12.0.0-brightgreen.svg)](https://nodejs.org)
4
6
 
5
- ## Quick Start
7
+ **Createur intelligent d'agents IA** | Merise Agile + TDD + 64 Mantras
6
8
 
7
- ```bash
8
- npx create-byan-agent
9
- ```
10
-
11
- That's it! The installer launches automatically.
12
-
13
- ## What is BYAN?
14
-
15
- BYAN guides you through an intelligent interview to create personalized AI agents:
16
-
17
- 1. ✅ Answer 12-15 simple questions (15-30 min)
18
- 2. ✅ BYAN analyzes your needs
19
- 3. ✅ Custom agent generated automatically
20
- 4. ✅ Ready to use immediately
9
+ ---
21
10
 
22
- ## Installation
11
+ ## Bonjour
23
12
 
24
- ### Option 1: NPX (Recommended)
13
+ Bonjour a tous ! J'ai l'honneur de vous presenter **BYAN**, votre ami sur vos projets — que vous soyez developpeur, vibe codeur ou juste curieux.
25
14
 
26
- ```bash
27
- npx create-byan-agent
28
- ```
15
+ > **Important :** Je precise 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 evolution active, et c'est precisement la ou reside son interet.
29
16
 
30
- ### Option 2: Global Install
17
+ ### Pourquoi BYAN existe
31
18
 
32
- ```bash
33
- npm install -g create-byan-agent
34
- create-byan-agent
35
- ```
19
+ Pour comprendre le contexte de BYAN, il faut comprendre pourquoi j'ai decide de le creer. La problematique de base est simple.
36
20
 
37
- ## Create Your First Agent
21
+ Je me suis retrouve avec un gros projet sur les bras, des deadlines tres serrees, pas de budget, et une equipe inexperimentee pour le faire. Ce qui m'a amene a faire des crunchs stupides avec des developpeurs en depression.
38
22
 
39
- ### 1. Launch BYAN
23
+ Pour resoudre ce probleme, m'est venue l'idee d'utiliser les agents IA pour accelerer le developpement du projet. Grace a un de mes etudiants en dev (credite dans les contributeurs du projet) a qui je donne cours, j'ai decouvert la methode **BMAD**, qui est un framework d'agents IA. Au depart sceptique, j'ai ete bluffe du resultat, bien que ces agents IA souffraient des biais habituels des IA, en particulier en fonction du modele utilise et de qui l'utilise et comment.
40
24
 
41
- **GitHub Copilot CLI:**
42
- ```bash
43
- gh copilot
44
- @byan
45
- ```
25
+ Alors une idee simple est venue : **et si on pouvait mettre un cadre a tous ces agents pour y apporter de "l'intelligence", peu importe le projet, en mettant des regles et contraintes de base pour contrer les biais des modeles d'IA ?**
46
26
 
47
- **Command Line:**
48
- ```bash
49
- npx create-byan-agent
50
- ```
27
+ C'est la que m'est venue l'idee de leur insuffler des **mantras** — des regles absolues auxquelles l'agent devait se conformer. Des gardes-fous epistemiques, methodologiques et comportementaux qui transforment un LLM bavard en partenaire fiable.
51
28
 
52
- ### 2. Choose Mode
29
+ Maintenant, la problematique se pose en multi-agents : comment faire pour que tous mes agents aient bien ces bonnes pratiques et regles ?
53
30
 
54
- **🎤 Full Interview (15-30 min)** - Recommended for first agent
55
- - 12-15 questions
56
- - In-depth analysis
57
- - Ultra-personalized agent
31
+ Il suffit de les instaurer a la source, c'est-a-dire **a la creation des agents**. C'est la que BYAN intervient : il va vous assister dans la creation intelligente d'agents IA.
58
32
 
59
- **⚡ Quick Create (5 min)** - For experienced users
60
- - 3-5 essential questions
61
- - Functional agent quickly
33
+ ### Ce que BYAN n'est pas
62
34
 
63
- ### 3. Answer Questions
35
+ 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, eprouver votre probleme et votre solution — mais mal utilise, il ne resoudra pas vos problemes comme par magie.
64
36
 
65
- BYAN asks questions in 4 categories:
37
+ C'est juste un agent intelligent avec les bons softskills et hardskills pour vous accompagner dans la realisation de vos projets.
66
38
 
67
- 1. **Context**: Your project, goals
68
- 2. **Business**: Domain, constraints
69
- 3. **Agent**: Desired skills, tasks
70
- 4. **Validation**: Confirmation, adjustments
39
+ ---
71
40
 
72
- ### 4. Automatic Generation
41
+ ## Installation
73
42
 
74
- ```
75
- ✅ Complete analysis
76
- ✅ Agent created: my-dev-agent.md
77
- ✅ Validated and ready
78
- ```
43
+ ### Prerequis
79
44
 
80
- Agent saved to:
81
- - GitHub Copilot: `.github/copilot/agents/`
82
- - Other platforms: `.codex/prompts/`
45
+ - Node.js >= 12.0.0
46
+ - npm >= 6.0.0
47
+ - Un compte GitHub Copilot, Claude Code ou Codex (selon la plateforme cible)
83
48
 
84
- ## Usage Examples
49
+ ### Installation rapide (recommandee)
85
50
 
86
- ### Code Review Agent
51
+ Aucune installation prealable n'est necessaire. Lancez simplement :
87
52
 
88
53
  ```bash
54
+ # Cree un nouveau projet BYAN (via npx, sans installation prealable)
89
55
  npx create-byan-agent
90
56
 
91
- # BYAN asks:
92
- # Purpose? → "Review JavaScript code"
93
- # Tasks? → "Detect bugs, suggest optimizations"
94
- # Constraints? → "Follow our style guide"
95
-
96
- # Result: code-reviewer.md created in 2 seconds
57
+ # Ou installation globale
58
+ npm install -g create-byan-agent
59
+ create-byan-agent
97
60
  ```
98
61
 
99
- ### Documentation Agent
100
-
101
- ```bash
102
- npx create-byan-agent
103
-
104
- # Purpose? → "Generate API documentation"
105
- # Tech? → "Node.js, Express, MongoDB"
106
- # Format? → "Markdown with examples"
62
+ L'installeur (Yanstaller) vous guide interactivement a travers le processus :
107
63
 
108
- # Result: doc-generator.md ready
64
+ ```
65
+ ? Nom du projet : mon-projet
66
+ ? Langue de communication : Francais
67
+ ? Plateforme cible : GitHub Copilot CLI
68
+ ? Activer le fact-check scientifique ? [Y/n]
69
+ ? Activer le systeme ELO de confiance ? [Y/n]
70
+ ? Optimiser les couts LLM automatiquement (~54% d'economies) ? [Y/n]
109
71
  ```
110
72
 
111
- ## Use Your Agent
73
+ ### Structure du projet apres installation
112
74
 
113
- ### With GitHub Copilot CLI
75
+ A la fin de l'installation, votre projet contient :
114
76
 
115
- ```bash
116
- gh copilot
117
- @my-dev-agent
118
- # Your agent responds!
77
+ ```
78
+ votre-projet/
79
+ _byan/ # Plateforme BYAN — coeur du systeme
80
+ _config/ # Manifestes des agents et workflows
81
+ _memory/ # Memoire persistante (ELO, fact-graph, session-state)
82
+ agents/ # Agents disponibles (core, bmm, bmb, cis, tea)
83
+ workflows/ # Workflows guides
84
+ soul.md # Ame de BYAN — personnalite, gardes-fous
85
+ tao.md # Voix de BYAN — signatures verbales, registre
86
+ soul-memory.md # Journal vivant des sessions
87
+ config.yaml # Configuration principale (langue, utilisateur, chemins)
88
+ .github/agents/ # Wrappers GitHub Copilot CLI
89
+ .codex/ # Integration Codex/OpenCode (si activee)
119
90
  ```
120
91
 
121
- ### With VSCode
122
-
123
- 1. Command Palette (Ctrl+Shift+P)
124
- 2. "GitHub Copilot: Chat"
125
- 3. Type `@my-dev-agent`
126
-
127
- ### With Claude Code
92
+ ---
128
93
 
129
- ```bash
130
- claude chat --agent my-dev-agent
131
- ```
94
+ ## Systeme Soul & Voice — Des Agents avec une Conscience
132
95
 
133
- ## Key Concepts (v2.0)
96
+ 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).
134
97
 
135
- ### 1. Intelligent Interview (4 phases)
98
+ ### Le Soul — Identite Abstraite
136
99
 
137
- ```
138
- CONTEXT → BUSINESS → AGENT → VALIDATION
139
- ```
100
+ 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 ?*
140
101
 
141
- Minimum 3 questions per phase = 12 total
102
+ ### Le Tao — De l'Abstrait au Concret
142
103
 
143
- ### 2. State Machine
104
+ 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.
144
105
 
145
- ```
146
- INTERVIEW → ANALYSIS → GENERATION → COMPLETED
147
- ```
106
+ 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*.
148
107
 
149
- ### 3. Template System
108
+ ### Installation du Soul
150
109
 
151
- Agents generated from professional templates with YAML frontmatter + XML structure.
110
+ Lors de l'installation, vous choisissez votre mode soul :
152
111
 
153
- ### 4. Automatic Validation
112
+ | Mode | Description |
113
+ |------|-------------|
114
+ | **Creator** | Utilise l'ame de Yan comme fondation + templates vierges pour la votre (recommande) |
115
+ | **Blank** | Templates vides a remplir vous-meme |
116
+ | **Import** | Importer des fichiers soul depuis un autre projet |
117
+ | **Skip** | Pas de soul (peut etre ajoute plus tard) |
154
118
 
155
- - ✅ Correct YAML format
156
- - ✅ Valid XML structure
157
- - ✅ No emojis in code (Mantra IA-23)
158
- - ✅ Valid agent name
159
- - ✅ Clear description
119
+ Construisez votre ame interactivement :
120
+ ```bash
121
+ @byan # Puis demandez le workflow Forge
122
+ @tao # Puis utilisez [FORGE-VOICE] pour construire votre voix
123
+ ```
160
124
 
161
- ### 5. Methodology: 64 Mantras
125
+ ---
162
126
 
163
- Quality principles applied:
164
- - **#37 Ockham's Razor**: Simplicity first
165
- - **IA-1 Trust But Verify**: Verify user needs
166
- - **IA-23 No Emoji Pollution**: Clean code
167
- - **IA-24 Clean Code**: Self-documenting
127
+ ## Architecture WCAW — Workflow/Context/Agent/Worker
168
128
 
169
- ## Advanced Configuration
129
+ BYAN est organise autour de quatre concepts fondamentaux :
170
130
 
171
- ### Customize Output
131
+ ### Agent
172
132
 
173
- ```javascript
174
- const ByanV2 = require('create-byan-agent');
133
+ Un specialiste IA avec une identite definie : persona, menu d'actions, regles (64 mantras), capabilities. Les agents sont definis en Markdown + XML dans `_byan/{module}/agents/`.
175
134
 
176
- const byan = new ByanV2({
177
- outputFolder: './my-agents',
178
- language: 'en',
179
- template: 'custom'
180
- });
181
- ```
135
+ ### Workflow
182
136
 
183
- ### Programmatic Usage
184
-
185
- ```javascript
186
- const ByanV2 = require('create-byan-agent');
187
-
188
- async function createAgent() {
189
- const byan = new ByanV2();
190
- await byan.startSession();
191
-
192
- const responses = [
193
- 'Backend development agent',
194
- 'REST API in Node.js',
195
- 'Tests, docs, deployment',
196
- // ... 12 responses total
197
- ];
198
-
199
- for (const response of responses) {
200
- await byan.getNextQuestion();
201
- await byan.submitResponse(response);
202
- }
203
-
204
- const profile = await byan.generateProfile();
205
- console.log('Agent created:', profile);
206
- }
207
- ```
137
+ Une sequence d'etapes guidees qu'un agent execute. Tri-modaux (Create/Validate/Edit), sequentiels (interview en 4 phases), ou utilitaires (fact-check, shard-doc).
208
138
 
209
- ## Useful Commands
139
+ ### Context Layer
210
140
 
211
- ```bash
212
- # List agents
213
- ls .github/copilot/agents/
141
+ La memoire partagee : `config.yaml`, `elo-profile.json`, `fact-graph.json`, `_byan-output/`.
214
142
 
215
- # Edit agent
216
- code .github/copilot/agents/my-agent.md
143
+ ### Worker
217
144
 
218
- # Validate agent
219
- npx create-byan-agent --validate my-agent.md
145
+ Un module utilitaire npm-installable pour un travail specifique en arriere-plan (fact-check, cost-optimizer).
220
146
 
221
- # Version
222
- npx create-byan-agent --version
223
147
  ```
148
+ VOUS -> @hermes "je veux creer un agent"
149
+ |
150
+ v
151
+ Agent (specialiste IA) --> Workflow (steps guides) --> Context Layer
152
+ | ^
153
+ +--> Worker (fact-check, cost-optimizer) -------+
154
+ ```
155
+
156
+ ---
224
157
 
225
- ## Help & Support
158
+ ## Agents Disponibles
226
159
 
227
- ### Get Help
160
+ 27 agents specialises en 5 modules :
228
161
 
229
- ```
230
- /bmad-help
231
- ```
162
+ | Module | Agents | Exemples |
163
+ |--------|--------|----------|
164
+ | **Core** | 4 | hermes (dispatcher), bmad-master, yanstaller, expert-merise-agile |
165
+ | **BMB** | 11 | byan (createur), fact-checker, marc, rachid, carmack, patnote |
166
+ | **BMM** | 9 | analyst (Mary), pm (John), architect (Winston), dev (Amelia), quinn (QA) |
167
+ | **CIS** | 6 | brainstorming-coach (Carson), storyteller (Sophia), problem-solver |
168
+ | **TEA** | 1 | tea (Murat) — master test architect |
232
169
 
233
- ### Documentation
170
+ ---
234
171
 
235
- - [Full Guide](https://github.com/Yan-Acadenice/BYAN/blob/main/GUIDE-UTILISATION.md)
236
- - [API Reference](https://github.com/Yan-Acadenice/BYAN/blob/main/API-BYAN-V2.md)
237
- - [Examples](https://github.com/Yan-Acadenice/BYAN/tree/main/examples)
172
+ ## Utilisation
238
173
 
239
- ### Common Issues
174
+ ### Avec GitHub Copilot CLI
240
175
 
241
- **Agent doesn't appear in Copilot**
242
176
  ```bash
243
- cat .github/copilot/agents/my-agent.md
244
- gh copilot quit && gh copilot
177
+ @hermes # Dispatcher universel — recommande le bon agent
178
+ @byan # Createur d'agents (interview intelligente)
179
+ @dev # Developpeur (Amelia)
180
+ @pm # Product Manager (John)
181
+ @architect # Architecte technique (Winston)
182
+ @fact-checker # Fact-check scientifique
245
183
  ```
246
184
 
247
- **"Node version too old"**
185
+ ### Avec Claude Code
186
+
248
187
  ```bash
249
- node --version # Must be >= 18
250
- nvm install 18 && nvm use 18
188
+ claude chat
189
+ @byan # Meme syntaxe, meme agents
251
190
  ```
252
191
 
253
- **Tests fail**
192
+ ### Avec Codex / OpenCode
193
+
254
194
  ```bash
255
- rm -rf node_modules package-lock.json
256
- npm install && npm test
195
+ codex prompt byan "help"
257
196
  ```
258
197
 
259
- ## Stats (v2.0)
198
+ ---
199
+
200
+ ## Workflows Principaux
260
201
 
261
- - ✅ **881/881 tests passing (100%)**
262
- - ✅ **14 modules**
263
- - ✅ **77 Story Points delivered**
264
- - ✅ **Agent in < 2 seconds** after interview
265
- - ✅ **64 mantras** applied automatically
202
+ | Workflow | Description | Agent |
203
+ |----------|-------------|-------|
204
+ | `create-prd` | Creer un Product Requirements Document | pm |
205
+ | `create-architecture` | Concevoir l'architecture technique | architect |
206
+ | `sprint-planning` | Planifier un sprint | sm |
207
+ | `dev-story` | Developper une user story | dev |
208
+ | `code-review` | Revoir du code | dev / quinn |
209
+ | `quick-spec` / `quick-dev` | Dev rapide brownfield | quick-flow-solo-dev |
210
+ | `testarch-atdd` | Tests ATDD avant implementation | tea |
266
211
 
267
- ## Use Cases
212
+ ---
213
+
214
+ ## Contributeurs
268
215
 
269
- **Developers**: Code review, test generation, refactoring, security analysis
216
+ ### Createur et Lead Developer
270
217
 
271
- **Writers**: Documentation, proofreading, translation, content creation
218
+ **[Yan-Acadenice](https://github.com/Yan-Acadenice)** — Conception, architecture, developpement de BYAN
272
219
 
273
- **Project Managers**: Ticket analysis, reports, planning, prioritization
220
+ ### Contributeur Principal — Agent Hermes
274
221
 
275
- **Designers**: UI components, accessibility, CSS optimization, design systems
222
+ **[Wazadriano](https://github.com/orgs/Centralis-V3/people/Wazadriano)** — Agent Hermes, Dispatcher Universel (v2.3.2)
276
223
 
277
- ## License
224
+ ### Remerciements
278
225
 
279
- MIT License
226
+ BYAN est construit au-dessus de la methode **[BMAD](https://github.com/bmadcode/BMAD-METHOD)**, decouverte grace a un etudiant de la formation **[Acadenice](https://acadenice.fr/)** a qui je donne cours.
227
+
228
+ ---
280
229
 
281
- ## Contributors
230
+ ## Licence
282
231
 
283
- **Core Team:**
284
- - **BYAN**: Intelligent agent creator
285
- - **RACHID**: NPM/NPX deployment specialist
286
- - **MARC**: GitHub Copilot CLI integration expert
287
- - **PATNOTE**: Update manager
288
- - **CARMACK**: Token optimizer
232
+ MIT © [Yan-Acadenice](https://github.com/Yan-Acadenice)
289
233
 
290
- ## Links
234
+ ## Liens
291
235
 
292
- - 📦 [NPM](https://www.npmjs.com/package/create-byan-agent)
293
- - 🐙 [GitHub](https://github.com/Yan-Acadenice/BYAN)
294
- - 📚 [Full Docs](https://github.com/Yan-Acadenice/BYAN/blob/main/install/README.md)
236
+ - [NPM](https://www.npmjs.com/package/create-byan-agent)
237
+ - [GitHub](https://github.com/Yan-Acadenice/BYAN)
238
+ - [Documentation complete](https://github.com/Yan-Acadenice/BYAN/blob/main/README.md)
295
239
 
296
240
  ---
297
241
 
298
- **BYAN v2.0** - Create professional AI agents in 15 minutes 🚀
242
+ *Fait avec de la frustration, de la curiosite, et l'envie que l'IA soit vraiment utile — pas juste impressionnante.*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-byan-agent",
3
- "version": "2.7.0",
3
+ "version": "2.7.1",
4
4
  "description": "BYAN v2.2.2 - Intelligent AI agent installer with multi-platform native support (GitHub Copilot CLI, Claude Code, Codex/OpenCode)",
5
5
  "bin": {
6
6
  "create-byan-agent": "bin/create-byan-agent-v2.js"