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

Version : 2.4.0 Statut : ✅ Production Ready Dernière mise à jour : 22 avril 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 (17 outils RooSync), un scheduler automatique Roo, et un protocole de coordination RooSync.

🏆 Réalisations Principales

✅ 6 machines actives : Coordination bicéphale Roo + Claude Code
✅ 5 MCPs déployés : roo-state-manager, playwright, markitdown, win-cli, sk-agent (github-projects-mcp RETIRÉ #368)
✅ RooSync v2.3 : Messagerie inter-machines + baseline-driven sync
✅ 17 outils MCP RooSync : Consolidés via CONS-1 à CONS-13, + claudish_traffic (#3391), + roosync_harmonization (#3545)
✅ 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
✅ ~13 400 tests unitaires : 720 fichiers .test.ts, 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/servers/roo-state-manager && 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 — le verrou vit sur l'issue (ADR 017, #3676) :

# 1. Vérifier qu'aucune autre machine ne tient le verrou, puis poser le sien
python scripts/github/check_issue_claim.py {NUM}                    # exit 1 = verrou tenu ailleurs
# exit 2 = erreur gh, ou depot indeterminable | exit 3 = numero ambigu entre les deux depots (#3768)
python scripts/github/check_issue_claim.py {NUM} --claim "intention en une ligne"

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

Le createdAt serveur du commentaire fait foi (jamais de timestamp dans le corps). Le dashboard workspace garde le récit de cycle, il n'est plus le registre de verrous. 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/                    # 18 subagents spécialisés
│   ├── skills/                    # 6 skills auto-invoqués
│   ├── commands/                  # 4 slash commands
│   ├── rules/                     # 17 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/         # 17 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-04-22)

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

MCP	Outils	Description
roo-state-manager	17	Messaging RooSync, config sync, task browsing, semantic search (post all CONS rounds)
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)
✅ 17 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 : docs/roosync/ESCALATION_MECHANISM.md

3. 🤖 Agents et Skills Claude Code

18 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é)
config-auditor	Audit configurations MCP et modes
codebase-researcher	Recherche SDDD multi-pass
script-runner	Exécution scripts avec gestion d'erreurs
pr-reviewer	Review autonome de pull requests
issue-triager	Classification et priorisation issues
sync-checker	Vérification rapide git/MCP/schtasks

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 : ~62s (~13 400 tests, 720 fichiers)

MCPs

roo-state-manager : 17 outils, <500ms réponse
sk-agent : 13 agents IA, 4 conversations, 4 modèles
Taux de réussite tests : mesuré à chaque run CI (historique 99.6%)

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/servers/roo-state-manager && 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 Agents : docs/harness/reference/agents-inventory.md
Serveurs MCP : mcps/README.md

Documentation RooSync v2.3

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

Guides Techniques

Dépannage MCP : docs/guides/TROUBLESHOOTING-GUIDE.md
Encodage UTF-8 : docs/dev/encoding/README.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 : $env:TEMP\claude-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 : 22 avril 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 : 17 outils roo-state-manager exposés (pass-through)
✅ CI Pipeline : GitHub Actions (Node 18+20, ubuntu-latest)
✅ Tests robustes : ~13 400 PASS sur 720 fichiers .test.ts
✅ 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
.claude		.claude
.github		.github
.roo		.roo
.vscode		.vscode
docker		docker
docs		docs
mcps		mcps
modules		modules
profiles		profiles
roo-code @ cb83656		roo-code @ cb83656
roo-code-customization		roo-code-customization
roo-config		roo-config
scripts		scripts
tests		tests
zoo-code @ 67df9f9		zoo-code @ 67df9f9
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitleaks.toml		.gitleaks.toml
.gitmodules		.gitmodules
.mcp.json.example		.mcp.json.example
.pre-commit-config.yaml		.pre-commit-config.yaml
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
vitest.config.ts		vitest.config.ts

Latest commit

History

Folders and files

Repository files navigation