🚀 Roo Extensions - Écosystème Multi-Agent de Développement Intelligent

Version : 2.4.0 Statut : ✅ Production Ready Dernière mise à jour : 03 mars 2026 GitHub Project : RooSync Multi-Agent Tasks #67

🎯 Vue d'Ensemble

Roo Extensions est un système multi-agent coordonné qui orchestre Roo (assistant VS Code) et Claude Code sur 6 machines en parallèle. Ce dépôt centralise des modes personnalisés, des serveurs MCP (36 outils RooSync), un scheduler automatique Roo, et un protocole de coordination RooSync.

🏆 Réalisations Principales

✅ 6 machines actives : Coordination bicéphale Roo + Claude Code
✅ 6 MCPs déployés : roo-state-manager, playwright, markitdown, win-cli, sk-agent, GitHub CLI
✅ RooSync v2.3 : Messagerie inter-machines + baseline-driven sync
✅ 36 outils MCP RooSync : Consolidés via CONS-1 à CONS-13
✅ Scheduler Roo automatique : Exécution toutes les 3h avec escalade CLI
✅ Scheduler Claude Code : Worker Haiku automatique via Windows Task Scheduler (NEW)
✅ GitHub Projects #67 : 242 items actifs
✅ 6867 tests unitaires : 378 fichiers, CI GitHub Actions (Node 18+20)

🚀 Démarrage Rapide

Prérequis

Roo installé et configuré dans VS Code
Claude Code CLI (optionnel, pour escalade Niveau 3)
PowerShell 7.2+ (recommandé pour scripts Windows)
Node.js 18+ (pour serveurs MCP)
Git 2.30+ (pour synchronisation et sous-modules)
Accès modèles : Anthropic Claude ou z.ai GLM-5

Installation en 4 Étapes

Cloner le dépôt et initialiser les sous-modules :

git clone https://github.com/jsboige/roo-extensions.git
cd roo-extensions
git submodule update --init --recursive

Déployer la configuration complète :

# Déploiement global (CLAUDE.md + agents + skills)
./.claude/configs/scripts/Deploy-GlobalConfig.ps1

# Déploiement des modes Roo
node roo-config/scripts/generate-modes.js
Copy-Item roo-config/modes/generated/simple-complex.roomodes .roomodes

# Déploiement du scheduler Roo
.\roo-config\scheduler\scripts\install\deploy-scheduler.ps1 -Action deploy

Installer et configurer les MCPs :

# Installation des MCPs internes
cd mcps/internal
npm install
npm run build
# Submodule: mcps/internal pointe vers jsboige-mcp-servers

Redémarrer VS Code et activer les nouveaux modes et MCPs

Protocol de Claim (Anti Double-Traitement)

Avant de travailler sur une tâche, toujours la revendiquer :

# 1. Commenter l'issue
gh issue comment {NUM} --repo jsboige/roo-extensions --body "🔒 Claimed by {MACHINE} (Claude Code)."

# 2. Mettre à jour Project #67
gh api graphql -f query="mutation { updateProjectV2ItemFieldValue(...) }"

Voir CLAUDE.md pour les IDs des champs Machine/Agent.

🏗️ Architecture Multi-Agent

Machines du Système

Machine	Rôle	MCPs
myia-ai-01	Coordinateur	GitHub CLI + RooSync + roo-state-manager
myia-po-2023	Exécutant	GitHub CLI + RooSync
myia-po-2024	Exécutant	GitHub CLI + RooSync
myia-po-2025	Exécutant	GitHub CLI + RooSync
myia-po-2026	Exécutant	GitHub CLI + RooSync
myia-web1	Exécutant	GitHub CLI + RooSync

Structure du Projet

roo-extensions/
├── 📁 .claude/                    # Configuration Claude Code agents
│   ├── agents/                    # 12 subagents spécialisés
│   ├── skills/                    # 6 skills auto-invoqués
│   ├── commands/                  # 4 slash commands
│   ├── rules/                     # 14 règles auto-chargées
│   └── local/                     # Communication locale (INTERCOM)
├── 📁 docs/                       # Documentation technique consolidée
│   ├── roosync/                   # Protocoles RooSync v2.3
│   ├── architecture/              # Designs et analyses
│   ├── guides/                    # Guides utilisateur
│   ├── scheduler/                 # Documentation scheduler (NOUVEAU)
│   └── framework-multi-agent/     # Templates coordination
├── 📁 mcps/internal/servers/
│   ├── roo-state-manager/         # 36 outils MCP (wrapper v4)
│   └── sk-agent/                  # 7 outils (Python FastMCP + Semantic Kernel)
├── 📁 roo-config/                 # Configuration centralisée
│   ├── modes/                     # 10 modes Roo (5 simple + 5 complex)
│   ├── scheduler/                 # Orchestration autonome (3h interval)
│   └── settings/                  # Paramètres globaux
├── 📁 scripts/
│   └── scheduling/                # Claude Code worker + Task Scheduler setup
└── 📄 CLAUDE.md                   # Guide principal agents

MCPs Actifs (2026-02-26)

5 serveurs MCP + GitHub CLI déployés sur 6 machines :

MCP	Outils	Description
roo-state-manager	36	Messaging RooSync, config sync, task browsing, semantic search
sk-agent	7	13 agents IA (Semantic Kernel) : analyst, researcher, critic, etc.
playwright	22	Browser automation, screenshots, form filling
markitdown	1	Conversion documents (PDF, DOCX, XLSX) → Markdown
win-cli	9	Windows CLI, SSH, commandes shell (fork local 0.2.0)

GitHub CLI (gh) - Remplace github-projects-mcp (#368). Issues, PRs, Projects via command line.

Documentation complète : mcps/README.md

🎯 Composants Principaux

1. 🔄 RooSync v2.3 - Coordination Multi-Machines

Architecture : 6 machines coordonnées (1 coordinateur + 5 exécutants)

Fonctionnalités Clés

✅ Messagerie inter-machines : roosync_send, roosync_read, roosync_manage (CONS-1)
✅ Configuration sync : collect, publish, apply, compare (CONS-2/3/4)
✅ Inventory automatique : Détection système complète (6 machines)
✅ Scheduler Roo : Orchestration autonome (3h interval, modes simple/complex)
✅ 35 outils MCP : Wrapper v4 pass-through (tasks, search, export, diagnostic)

Workflow Principal

Collect → Publish → Compare → Validate → Apply

Modes Coordination

Bicéphale : Roo (technique) + Claude Code (coordination/documentation)
Double scheduler : Roo (3h, modes simple/complex) + Claude Code (3h, Haiku avec escalade)
Communication : RooSync (inter-machines), INTERCOM (locale Roo ↔ Claude)

Documentation complète : docs/roosync/GUIDE-TECHNIQUE-v2.3.md

2. 🎭 Modes Roo Personnalisés

Architecture à 2 Niveaux

Modes Simples : Tâches courantes (GLM-5 gratuit)
Modes Complexes : Tâches avancées (GLM-5 + escalade CLI)

5 Familles de Modes

Code : Développement et refactoring
Debug : Diagnostic et résolution problèmes
Architect : Conception et architecture
Ask : Questions et recherche
Orchestrator : Coordination et délégation

Escalade Automatique

-simple → -complex → claude -p (CLI)

Documentation : .claude/ESCALATION_MECHANISM.md

3. 🤖 Agents et Skills Claude Code

12 Subagents Disponibles

Agent	Usage
git-sync	Pull conservatif + résolution conflits
test-runner	Build + tests unitaires
code-fixer	Investigation et correction bugs
code-explorer	Exploration codebase
doc-updater	Mise à jour documentation
test-investigator	Investigation tests échoués/instables
roosync-hub	Hub central messages RooSync (coordinateur)
dispatch-manager	Assignation tâches aux machines (coordinateur)
task-planner	Planification multi-agent (coordinateur)
roosync-reporter	Rapports au coordinateur (exécutant)
task-worker	Exécution tâches assignées (exécutant)
consolidation-worker	Consolidations CONS-X (spécialisé)

6 Skills Auto-Invoqués

sync-tour : Tour de sync complet (9 phases)
validate : CI local (build + tests)
git-sync : Synchronisation Git
github-status : État Project #67
redistribute-memory : Audit et redistribution mémoire
debrief : Analyse session + capture leçons

Documentation : .claude/agents/ et .claude/skills/

📊 Métriques et Performance

Infrastructure

6 machines actives : Coordination 24/7
Scheduler Roo : Toutes les 3h (staggered par machine)
Scheduler Claude Code : Worker Haiku toutes les 3h (ai-01, pilot)
CI GitHub Actions : Node 18+20 sur ubuntu-latest
Build + Tests : ~56s (6867 tests, 378 fichiers)

MCPs

roo-state-manager : 36 outils, <500ms réponse
sk-agent : 13 agents IA, 4 conversations, 4 modèles
Taux de réussite tests : 99.7% (6867/6887)

RooSync v2.3

Messagerie : <1s latence inter-machines (GDrive partagé)
Baseline sync : 2-4s par machine
Qdrant : 20 collections, 212K+ vecteurs (2560 dims)

🚀 Guides Démarrage Rapide

Installation Complète pour Nouveaux Utilisateurs

# 1. Cloner et initialiser
git clone https://github.com/jsboige/roo-extensions.git
cd roo-extensions
git submodule update --init --recursive

# 2. Déployer configuration globale (Claude Code)
./.claude/configs/scripts/Deploy-GlobalConfig.ps1

# 3. Déployer modes Roo + scheduler
node roo-config/scripts/generate-modes.js
Copy-Item roo-config/modes/generated/simple-complex.roomodes .roomodes
./roo-config/scheduler/scripts/install/deploy-scheduler.ps1 -Action deploy

# 4. Installer MCPs internes
cd mcps/internal && npm install && npm run build

# 5. Redémarrer VS Code

Configuration MCP roo-state-manager

{
  "mcpServers": {
    "roo-state-manager": {
      "command": "node",
      "args": ["mcps/internal/servers/roo-state-manager/mcp-wrapper.cjs"],
      "transportType": "stdio",
      "env": {
        "ROOSYNC_SHARED_PATH": "G:/Mon Drive/Synchronisation/RooSync/.shared-state"
      }
    }
  }
}

📚 Documentation Complète

Points d'Entrée Principaux

Guide Agent Claude Code : CLAUDE.md
Architecture Multi-Agent : .claude/INDEX.md
Serveurs MCP : mcps/README.md
Escalade Roo : .claude/ESCALATION_MECHANISM.md

Documentation RooSync v2.3

Guide Technique : docs/roosync/GUIDE-TECHNIQUE-v2.3.md
Protocole INTERCOM : .claude/INTERCOM_PROTOCOL.md

Guides Techniques

Dépannage MCP : docs/guides/TROUBLESHOOTING-GUIDE.md
Encodage UTF-8 : docs/encoding/quick-start-encoding.md

🛠️ Dépannage et Support

Problèmes Courants

MCPs ne démarrent pas
- Vérifier installation Node.js 18+
- Exécuter npm install && npm run build dans mcps/internal
- Redémarrer VS Code (les MCPs sont chargés au démarrage uniquement)
Outils MCP non disponibles
- Vérifier ~/.claude.json → section mcpServers
- Tester le serveur : node mcps/internal/servers/roo-state-manager/mcp-wrapper.cjs
- Consulter docs/guides/TROUBLESHOOTING-GUIDE.md
Scheduler Roo ne s'exécute pas
- Vérifier .roo/schedules.json existe
- Extension Roo Scheduler installée ?
- Voir les traces : %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\tasks\
Modes non disponibles
- Vérifier .roomodes existe à la racine
- Régénérer : node roo-config/scripts/generate-modes.js
Scheduler Claude Code
- Vérifier le Task Scheduler : .\scripts\scheduling\setup-scheduler.ps1 -Action list
- Logs : .claude/logs/worker-*.log
- Tester manuellement : .\scripts\scheduling\setup-scheduler.ps1 -Action test

Support Technique

Documentation : CLAUDE.md + docs/
Issues GitHub : github.com/jsboige/roo-extensions/issues

🤝 Contribution

Workflow de Contribution

Claimer l'issue : gh issue comment {NUM} --body "🔒 Claimed by {MACHINE}"
Créer une branche pour vos modifications
Tester : npx vitest run (JAMAIS npm test)
Documenter dans docs/ si changement significatif
Soumettre une PR avec description complète

Règles Importantes

Toujours lire un fichier avant de le modifier (Edit tool l'exige)
Utiliser npx vitest run pour les tests (pas npm test)
Commit submodule en premier : mcps/internal est un submodule git
Ne jamais utiliser --force sur les branches partagées

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

🎯 Statut du Projet

Version actuelle : 2.4.0 Statut : ✅ Production Ready Dernière mise à jour : 03 mars 2026 GitHub Project : 242 items actifs

Accomplissements v2.4

✅ Architecture multi-agent : 6 machines coordonnées (1 coordinateur + 5 exécutants)
✅ Scheduler Roo : Orchestration autonome (3h interval, modes simple/complex, escalade)
✅ Scheduler Claude Code : Worker Haiku automatique (Windows Task Scheduler, escalade vers Sonnet/Opus)
✅ Wrapper MCP v4 : 36 outils roo-state-manager exposés (pass-through)
✅ CI Pipeline : GitHub Actions (Node 18+20, ubuntu-latest)
✅ Tests robustes : 6867 PASS sur 378 fichiers
✅ sk-agent : 13 agents IA via FastMCP + Semantic Kernel
✅ codebase_search : Recherche sémantique dans le code (Qdrant + embeddings)
✅ SDDD v2 : Triple grounding (sémantique + conversationnel + technique) avec bookend pattern
✅ STOP & REPAIR protocol : Détection automatique et réparation des outils MCP manquants

Roadmap

v2.5 : Scheduler Claude Code multi-machine (#534) + config-sync opérationnel (#537)
v3.0 : Autonomie avancée (worktrees, PRs automatiques, tâches complex sans supervision)

🚀 Prêt à transformer votre développement multi-machines avec Roo Extensions ?

Consultez CLAUDE.md pour le guide complet de l'agent Claude Code.

Name		Name	Last commit message	Last commit date
Latest commit History 2,920 Commits
.claude		.claude
.github		.github
.roo		.roo
.vscode		.vscode
archive		archive
demo-roo-code		demo-roo-code
docker		docker
docs		docs
mcps		mcps
modules		modules
profiles		profiles
roo-code @ 3928682		roo-code @ 3928682
roo-code-customization		roo-code-customization
roo-config		roo-config
scripts		scripts
tests		tests
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

🚀 Roo Extensions - Écosystème Multi-Agent de Développement Intelligent

🎯 Vue d'Ensemble

🏆 Réalisations Principales

🚀 Démarrage Rapide

Prérequis

Installation en 4 Étapes

Protocol de Claim (Anti Double-Traitement)

🏗️ Architecture Multi-Agent

Machines du Système

Structure du Projet

MCPs Actifs (2026-02-26)

🎯 Composants Principaux

1. 🔄 RooSync v2.3 - Coordination Multi-Machines

Fonctionnalités Clés

Workflow Principal

Modes Coordination

2. 🎭 Modes Roo Personnalisés

Architecture à 2 Niveaux

5 Familles de Modes

Escalade Automatique

3. 🤖 Agents et Skills Claude Code

12 Subagents Disponibles

6 Skills Auto-Invoqués

📊 Métriques et Performance

Infrastructure

MCPs

RooSync v2.3

🚀 Guides Démarrage Rapide

Installation Complète pour Nouveaux Utilisateurs

Configuration MCP roo-state-manager

📚 Documentation Complète

Points d'Entrée Principaux

Documentation RooSync v2.3

Guides Techniques

🛠️ Dépannage et Support

Problèmes Courants

Support Technique

🤝 Contribution

Workflow de Contribution

Règles Importantes

📄 Licence

🎯 Statut du Projet

Accomplissements v2.4

Roadmap

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages