🏠 HOUSE Claude Flow - Installateur Intelligent

Installateur automatique du workflow HOUSE pour Claude Code avec orchestration intelligente des agents

"Vous ne passerez pas... sans une documentation complète !" - Gandalf

📋 Table des matières

• Vue d'ensemble
• Installation
• Prérequis
• Guide d'utilisation
• Commandes disponibles
• Structure du projet
• Configuration des agents HOUSE
• Exemples d'utilisation
• Troubleshooting
• Architecture interne
• Contribution

🎯 Vue d'ensemble

HOUSE Claude Flow est un installateur NPM qui configure automatiquement un environnement de développement révolutionnaire basé sur le framework HOUSE (Honesty + Orchestration + Uncompromising + Standards + Engineering) avec Claude-Flow.

Qu'est-ce que le système HOUSE ?

Le système HOUSE transforme vos demandes en graphes de tâches atomiques orchestrés par FRIDAY, avec 10 agents spécialisés qui travaillent en parallèle sous des gates de qualité 100/100 obligatoires.

Pourquoi utiliser HOUSE Claude Flow ?

• 🚀 Installation en 1 commande : house-setup configure tout automatiquement
• ⚡ Exécution parallèle : Jusqu'à 15 agents simultanés coordonnés
• 🎯 Qualité garantie : Gates de qualité 100/100 avec Dr. House et Tyrion
• 🧠 Mémoire persistante : Context et apprentissage entre sessions
• 🔄 Orchestration intelligente : FRIDAY décompose et coordonne automatiquement
• 📚 Documentation complète : Spécifications et architecture auto-générées

🚀 Installation Rapide

Installation globale (recommandée)

# Installation NPM globale
npm install -g house-claude-flow

# Configuration automatique
house-setup

Installation locale

# Cloner le repository
git clone https://github.com/house-team/house-claude-flow.git
cd house-claude-flow

# Installer les dépendances
npm install

# Configurer HOUSE
npm run setup

Installation simplifiée (sans prompts)

house-setup-simple
# ou
npm run setup-simple

💻 Prérequis

Système requis

• Node.js >= 16.0.0 ✨
• npm >= 7.0.0 ou yarn >= 1.22.0
• Git (pour le clonage et les hooks)
• Claude CLI (installé automatiquement si absent)

Vérification des prérequis

# Vérifier Node.js
node --version  # doit être >= 16.0.0

# Vérifier npm
npm --version   # doit être >= 7.0.0

# Tester l'installation
house-test

📖 Guide d'utilisation

Étape 1 : Installation interactive

house-setup

L'installateur vous guide à travers :

1. 🔍 Vérification des dépendances : Node.js, npm, Claude CLI
2. 📁 Création de la structure : .claude/, memory/, configurations
3. 🤖 Installation des agents : 10 agents HOUSE spécialisés
4. ⚙️ Configuration MCP : Serveurs claude-flow et ruv-swarm
5. ✅ Validation complète : Tests de tous les composants

Étape 2 : Configuration MCP (automatique)

Les serveurs MCP sont configurés automatiquement :

# Ces commandes sont exécutées automatiquement
claude mcp add claude-flow npx claude-flow@alpha mcp start
claude mcp add ruv-swarm npx ruv-swarm@latest mcp start

Étape 3 : Premier démarrage HOUSE

# Démarrer un projet avec orchestration HOUSE
claude --config=CLAUDE.md "Créer une API REST avec authentification JWT"

🎉 FRIDAY va automatiquement :

1. Analyser les exigences (hermione-researcher)
2. Planifier l'architecture (tony-stark-planner)
3. Développer le backend (scotty-engineer)
4. Tester le code (tyrion-tester)
5. Revoir la qualité (dr-house-reviewer)

🛠️ Commandes disponibles

Commandes principales

| Commande | Description | Exemple | |----------|-------------|---------| | house-setup | Installation interactive complète | house-setup | | house-setup-simple | Installation simplifiée sans prompts | house-setup-simple | | house-test | Test et validation de l'installation | house-test | | house-demo | Démonstration complète avec exemples | house-demo | | house-help | Guide d'utilisation détaillé | house-help --version |

Scripts npm equivalents

npm run setup          # = house-setup
npm run setup-simple   # = house-setup-simple
npm test              # = house-test
npm run demo          # = house-demo
npm run help          # = house-help

Commandes post-installation

# Démarrer un workflow HOUSE
claude --config=CLAUDE.md "votre demande"

# Vérifier le statut MCP
claude mcp list

# Consulter la documentation des agents
ls .claude/agents/house/

# Voir l'historique des sessions
ls memory/sessions/

📁 Structure du projet créé

L'installateur crée automatiquement cette structure complète :

projet-racine/
├── 📄 CLAUDE.md                    # Configuration principale HOUSE
├── 📁 .claude/                     # Configuration Claude Code
│   ├── 🤖 agents/house/            # 10 agents spécialisés HOUSE
│   │   ├── bishop-database.md      # Architecte base de données
│   │   ├── dr-house-reviewer.md    # Réviseur code expert
│   │   ├── gandalf-specs-writer.md # Rédacteur spécifications
│   │   ├── hermione-researcher.md  # Chercheuse analytique
│   │   ├── legolas-frontend.md     # Développeur frontend
│   │   ├── neo-ml-specialist.md    # Spécialiste ML/IA
│   │   ├── optimus-devops.md       # Expert DevOps
│   │   ├── scotty-engineer.md      # Ingénieur principal
│   │   ├── tony-stark-planner.md   # Planificateur architectural
│   │   └── tyrion-tester.md        # Testeur méticuleux
│   ├── 🎯 strategies/              # Stratégies d'orchestration
│   │   ├── friday-agent.md         # Personnalité FRIDAY
│   │   ├── house-workflow.md       # Workflow HOUSE complet
│   │   ├── architecture.md         # Standards architecture
│   │   └── documentation.md        # Standards documentation
│   ├── 📋 commands/                # Commandes personnalisées
│   ├── 🔗 hooks/                   # Hooks d'intégration
│   ├── ⚙️ settings.json            # Configuration Claude
│   └── 🌐 mcp-servers.json         # Serveurs MCP
├── 💾 memory/                      # Mémoire persistante
│   ├── agents/                     # Mémoire des agents
│   └── sessions/                   # Sessions sauvegardées
└── 📊 logs/                        # Logs de production (optionnel)

Fichiers clés créés

CLAUDE.md - Configuration principale

Contient la configuration complète de FRIDAY, les règles d'orchestration, et les protocoles d'agents.

.claude/mcp-servers.json - Serveurs MCP

{
  "claude-flow": {
    "command": "npx",
    "args": ["claude-flow@alpha", "mcp", "start"],
    "description": "Orchestrateur Claude Flow"
  },
  "ruv-swarm": {
    "command": "npx", 
    "args": ["ruv-swarm@latest", "mcp", "start"],
    "description": "Coordination avancée des agents"
  }
}

🤖 Configuration des agents HOUSE

Les 10 agents spécialisés

Chaque agent a un rôle précis dans l'écosystème HOUSE :

🧠 Équipe d'analyse

| Agent | Rôle | Spécialité | Couleur | |-------|------|------------|---------| | Tony Stark | Planificateur architectural | Architecture, planification technique | 🔴 Rouge | | Hermione | Chercheuse analytique | Recherche profonde, best practices | 🔵 Bleu | | Bishop | Architecte base de données | Schémas, optimisation DB | ⚫ Noir |

🛠️ Équipe d'implémentation

| Agent | Rôle | Spécialité | Couleur | |-------|------|------------|---------| | Scotty | Ingénieur principal | Backend, APIs, intégrations | 🟡 Jaune | | Legolas | Développeur frontend | UI/UX, design systems | 🟢 Vert | | Neo | Spécialiste ML/IA | Machine Learning, IA | 🟣 Violet |

✅ Équipe qualité

| Agent | Rôle | Spécialité | Couleur | |-------|------|------------|---------| | Dr. House | Réviseur expert | Code review, qualité 100/100 | 🔵 Bleu | | Tyrion | Testeur méticuleux | Tests d'intégration, validation | 🟤 Marron |

📚 Équipe support

| Agent | Rôle | Spécialité | Couleur | |-------|------|------------|---------| | Gandalf | Rédacteur spécifications | Documentation, spécs techniques | 🟣 Violet | | Optimus | Expert DevOps | Déploiement, infrastructure | 🔴 Rouge |

Configuration des agents

Chaque agent dispose de :

• Personnalité unique avec phrases caractéristiques
• Outils spécialisés (Read, Write, Edit, Glob, Grep, MCP)
• Protocoles de coordination avec hooks automatiques
• Cache intelligent pour optimiser les performances
• Mémoire persistante pour le context entre sessions

💡 Exemples d'utilisation

Exemple 1 : API REST complète

claude --config=CLAUDE.md "Créer une API REST pour un blog avec authentification JWT, CRUD articles, et base de données PostgreSQL"

Orchestration automatique par FRIDAY :

1. Tony Stark : Planifie l'architecture (30 min)
2. Hermione : Recherche best practices REST + JWT (20 min)
3. Bishop : Conçoit le schéma PostgreSQL (25 min)
4. Gandalf : Rédige les spécifications complètes (15 min)
5. Scotty : Développe l'API backend (90 min)
6. Dr. House : Review qualité 100/100 (30 min)
7. Tyrion : Tests d'intégration complets (45 min)
8. Optimus : Configuration déploiement (20 min)

Résultat : API complète, testée, documentée, déployable en ~4h avec qualité garantie.

Exemple 2 : Application full-stack React

claude --config=CLAUDE.md "Application de gestion de tâches : React frontend, Node.js backend, MongoDB, authentification, temps réel avec WebSocket"

Exécution parallèle intelligente :

graph TD
    A[FRIDAY: Analyse initiale] --> B[Tony: Architecture]
    A --> C[Hermione: Recherche React/Node.js]
    A --> D[Bishop: Schéma MongoDB]
    
    B --> E[Gandalf: Spécifications]
    C --> E
    D --> E
    
    E --> F[Scotty: API Node.js]
    E --> G[Legolas: Frontend React]
    
    F --> H[Dr. House: Review backend]
    G --> I[Dr. House: Review frontend]
    
    H --> J[Tyrion: Tests intégration]
    I --> J
    
    J --> K[Optimus: Déploiement]

Exemple 3 : Microservice ML

claude --config=CLAUDE.md "Microservice de recommandations ML : FastAPI, scikit-learn, Redis cache, API REST avec monitoring Prometheus"

Agents spécialisés activés :

• Neo : Architecture ML et algorithmes
• Scotty : FastAPI et intégrations
• Bishop : Optimisation Redis
• Optimus : Monitoring Prometheus

🔧 Dépannage et FAQ

Problèmes courants

❌ Erreur : "house-setup: command not found"

# Solution 1 : Installation globale manquante
npm install -g house-claude-flow

# Solution 2 : PATH non configuré
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bashrc
source ~/.bashrc

# Solution 3 : Utiliser npm run
npm run setup

❌ Erreur : "Permission denied"

# Solution 1 : sudo pour installation globale
sudo npm install -g house-claude-flow

# Solution 2 : Configurer npm sans sudo
npm config set prefix ~/.npm-global
echo 'export PATH="$PATH:$HOME/.npm-global/bin"' >> ~/.bashrc
source ~/.bashrc

❌ Erreur : "Claude CLI not found"

# Installation manuelle Claude CLI
npm install -g @anthropic-ai/claude-3

# Ou laisser l'installateur le faire automatiquement
house-setup  # Il installera Claude CLI automatiquement

❌ Erreur : "MCP servers failed to start"

# Vérifier les serveurs MCP
claude mcp list

# Réinstaller les serveurs
claude mcp remove claude-flow
claude mcp remove ruv-swarm
house-setup  # Reconfiguration automatique

# Test manuel
npx claude-flow@alpha mcp start
npx ruv-swarm@latest mcp start

Tests de diagnostic

Diagnostic complet

house-test

Sortie attendue :

🏠 HOUSE Claude Flow - Test d'installation
═══════════════════════════════════════════

✅ Node.js version: 18.17.0 (>= 16.0.0)
✅ npm version: 9.8.1 (>= 7.0.0)
✅ Claude CLI: Installé et configuré
✅ Structure .claude/: Complète (agents, strategies, commands)
✅ Agents HOUSE: 10/10 agents installés
✅ CLAUDE.md: Configuration principale présente
✅ MCP Servers: claude-flow ✅, ruv-swarm ✅
✅ Mémoire: Répertoires memory/ créés

🎉 Installation HOUSE parfaite ! Le système est prêt.

Test spécifique d'un composant

# Test uniquement les agents
house-test --agents

# Test uniquement MCP
house-test --mcp

# Test avec verbosité
house-test --verbose

FAQ

Q: Quelle est la différence entre house-setup et house-setup-simple ?

R: house-setup est interactif avec des prompts de confirmation pour chaque étape. house-setup-simple installe tout automatiquement sans demander de confirmation.

Q: Puis-je utiliser HOUSE avec un projet existant ?

R: Oui ! L'installateur détecte les fichiers existants et demande avant de les écraser. Vos fichiers sont préservés.

Q: Comment mettre à jour les agents HOUSE ?

R: Relancez house-setup. L'installateur met à jour automatiquement les agents vers les dernières versions.

Q: HOUSE fonctionne-t-il avec d'autres LLM que Claude ?

R: HOUSE est optimisé pour Claude Code, mais les agents peuvent théoriquement être adaptés à d'autres LLM. Cependant, les performances ne sont pas garanties.

Q: Puis-je créer mes propres agents personnalisés ?

R: Les agents HOUSE sont préconfigurés et optimisés. Pour des besoins spécifiques, consultez la documentation avancée de Claude Flow.

Q: Comment résoudre les conflits entre agents ?

R: FRIDAY orchestre automatiquement les dépendances. En cas de conflit, consultez les logs dans memory/sessions/ ou relancez avec claude --debug.

Q: Les sessions HOUSE sont-elles persistantes ?

R: Oui ! La mémoire est sauvegardée dans memory/sessions/ et restaurée automatiquement entre les sessions.

🏗️ Architecture interne

Composants du package

house-claude-flow/
├── 📦 bin/                         # Exécutables
│   ├── install.js                  # Installateur principal
│   ├── install-simple.js           # Installation simplifiée
│   ├── test-install.js             # Tests d'installation
│   ├── demo.js                     # Démonstration
│   └── help.js                     # Aide contextuelle
├── 🏠 house-flow/                  # Assets HOUSE
│   ├── .claude/                    # Configuration Claude
│   └── memory/                     # Structure mémoire
├── 📄 templates/                   # Templates de configuration
├── 📋 package.json                 # Configuration npm
└── 📚 README.md                    # Cette documentation

Workflow d'installation

graph TD
    A[house-setup] --> B{Vérifier Node.js >= 16}
    B -->|❌| C[Erreur: Mettre à jour Node.js]
    B -->|✅| D[Vérifier npm]
    
    D --> E{Claude CLI installé ?}
    E -->|❌| F[Installer Claude CLI]
    E -->|✅| G[Créer structure .claude/]
    F --> G
    
    G --> H[Copier agents HOUSE]
    H --> I[Configurer CLAUDE.md]
    I --> J[Setup MCP servers]
    J --> K[Créer memory/]
    K --> L[Tests finaux]
    L --> M[✅ Installation réussie]

Protocole d'orchestration FRIDAY

Phase 1 : Analyse et décomposition

// FRIDAY analyse la demande utilisateur
const userRequest = "Créer une API REST";

// Décomposition en graphe de tâches atomiques
const taskGraph = {
  "analysis": {
    "tony-architecture": { dependencies: [], duration: 30 },
    "hermione-research": { dependencies: [], duration: 20 },
    "bishop-database": { dependencies: [], duration: 25 }
  },
  "synthesis": {
    "gandalf-specs": { 
      dependencies: ["tony-architecture", "hermione-research", "bishop-database"], 
      duration: 15 
    }
  },
  "implementation": {
    "scotty-backend": { dependencies: ["gandalf-specs"], duration: 90 }
  },
  "quality": {
    "house-review": { dependencies: ["scotty-backend"], duration: 30 },
    "tyrion-tests": { dependencies: ["house-review"], duration: 45 }
  }
};

Phase 2 : Exécution parallèle coordonnée

// Orchestration avec respect des dépendances
await Promise.all([
  spawnAgent("tony-stark-planner", taskGraph.analysis["tony-architecture"]),
  spawnAgent("hermione-researcher", taskGraph.analysis["hermione-research"]),
  spawnAgent("bishop-database", taskGraph.analysis["bishop-database"])
]);

// Attendre la completion avant la suite
await waitForCompletion(["tony-architecture", "hermione-research", "bishop-database"]);

// Phase suivante
await spawnAgent("gandalf-specs-writer", taskGraph.synthesis["gandalf-specs"]);

Architecture MCP

Le système utilise deux serveurs MCP principaux :

claude-flow@alpha

• Orchestration des tâches et agents
• Mémoire persistante et cache
• Hooks et événements
• Monitoring en temps réel

ruv-swarm@latest

• Coordination avancée des agents
• Optimisation topologique
• Performance et métriques
• Consensus et synchronisation

🤝 Contribution et maintenance

Structure de développement

# Forker et cloner le projet
git clone https://github.com/your-username/house-claude-flow.git
cd house-claude-flow

# Installer les dépendances de développement
npm install

# Tester en local
npm test

# Tester l'installation
npm run demo

Standards de contribution

Code Style

• JavaScript : Standard ES2020+, async/await privilégié
• Documentation : JSDoc pour toutes les fonctions publiques
• Tests : Jest pour les tests unitaires
• Linting : ESLint avec configuration standard

Structure des commits

type(scope): description courte

Description détaillée si nécessaire

- Changement 1
- Changement 2

Fixes #issue-number

Types autorisés : feat, fix, docs, style, refactor, test, chore

Roadmap

Version 1.1.0 (Q4 2024)

• [ ] Support Windows PowerShell natif
• [ ] Interface web pour monitoring HOUSE
• [ ] Intégration VS Code extension
• [ ] Templates de projets préconfigurés

Version 1.2.0 (Q1 2025)

• [ ] Support Docker avec images optimisées
• [ ] CI/CD templates (GitHub Actions, GitLab CI)
• [ ] Métriques avancées et dashboards
• [ ] API REST pour contrôle external

Version 2.0.0 (Q2 2025)

• [ ] Agents personnalisables par utilisateur
• [ ] Cloud orchestration avec scaling automatique
• [ ] Intégration IDE multiple (IntelliJ, Sublime)
• [ ] Marketplace d'agents communautaires

Maintenance et support

Cycle de release

• Patches : Correctifs critiques sous 48h
• Minor : Nouvelles fonctionnalités mensuelles
• Major : Évolutions architecturales trimestrielles

Support communautaire

• GitHub Issues : Bug reports et feature requests
• Discussions : Questions et aide communautaire
• Wiki : Documentation avancée collaborative

License

MIT License - voir le fichier LICENSE pour les détails complets.

🧙‍♂️ Développé par Gandalf - HOUSE Engineering Team

"Vous ne passerez pas... sans une installation parfaite !"

Le HOUSE gagne toujours grâce à l'orchestration intelligente !