Orchestral

Agent IA agentique pour Claude Code — Automatise le pipeline complet de gestion de projet : du cahier des charges au code déployé.

Concept

Orchestral fournit 3 agents IA spécialisés et 16 workflows qui transforment Claude Code en chef de projet, designer UX et développeur senior. Chaque agent a sa personnalité, ses connaissances métier et ses workflows dédiés.

CDC client → Validation → Tickets → UX/UI → Stack Research → Architecture → Code → Audit → GitHub

Installation

npx orchestral install

Cela installe dans votre projet :

votre-projet/
├── .claude/              ← Configuration Claude Code (commands, rules, skills)
│   ├── commands/orcl/    ← Slash commands des 3 agents
│   ├── rules/            ← Règles qualité (tickets, specs)
│   ├── skills/           ← Capacités spécialisées
│   └── settings.local.json
├── _orcl/                ← Données Orchestral
│   ├── client/specs/     ← Vos cahiers des charges
│   ├── output/           ← Artefacts générés
│   ├── workflows/        ← Workflows shardés en steps
│   └── templates/        ← Templates de rapports

Note : _orcl/ peut être ajouté à votre .gitignore si vous ne souhaitez pas versionner les artefacts Orchestral.

Utilisation

Lancer un agent

Dans Claude Code, tapez une des commandes suivantes :

| Commande | Agent | Description | |----------|-------|-------------| | /orcl/agents/pm | Product Manager | Gestion de projet, CDC, tickets | | /orcl/agents/ux | UX/UI Specialist | Design, standards, wireframes | | /orcl/agents/dev | Developer | Code, tests, architecture |

Chaque agent affiche ses commandes disponibles et détecte automatiquement la phase du projet.

Pipeline Product Manager

/orcl/workflow/validate-cdc        Valider un cahier des charges
/orcl/workflow/create-tickets      Découper le CDC en tickets
/orcl/workflow/validate-tickets    Valider chaque ticket
/orcl/workflow/push-kanban         Pousser sur GitHub Projects

Workflow :

1. Placez votre CDC dans _orcl/client/specs/
2. Lancez /orcl/agents/pm — l'agent détecte le CDC et vous guide
3. Validation du CDC (principe STOP si ambiguïté)
4. Découpage en tickets INVEST
5. Push vers GitHub Projects (Kanban)

Pipeline UX/UI

/orcl/ux/recherche-standard    Rechercher les standards applicables (WCAG, Nielsen...)
/orcl/ux/recherche-ui          Rechercher les patterns UI adaptés
/orcl/ux/create-ux             Créer les livrables UX (personas, flows, wireframes)
/orcl/ux/verify-ux             Auditer un design existant

Pipeline Développeur

/orcl/dev/recherche-stack          Rechercher best practices & packages du framework
/orcl/dev/recherche-architecture   Définir l'architecture technique
/orcl/dev/implement-ticket         Implémenter un ticket du backlog
/orcl/dev/create-tests             Créer les tests
/orcl/dev/review-code              Code review structuré
/orcl/dev/audit-code               Audit qualité / sécurité / performance

One-shot : projet complet

/orcl/dev/batch-implementation

Orchestre les 3 agents en 12 étapes automatiques :

Intake → GitHub → CDC → Tickets → UX → Stack → Architecture → Scaffold → Implement → Audit → Push → Output

Fonctionnalités clés

Recherche-first

L'agent Dev effectue des recherches approfondies sur votre stack avant d'écrire du code. Il génère une règle dynamique (.claude/rules/stack-[framework].md) qui guide automatiquement tout le code produit.

Stacks supportées : Next.js, Flutter, et toute stack recherchée via /orcl/dev/recherche-stack.

Progressive Disclosure

Les workflows sont découpés en steps atomiques, chargés un par un. Cela permet à Claude Code de traiter chaque étape avec toute son attention sans surcharge de contexte.

Principe STOP

Si une information est ambiguë, manquante ou contradictoire, l'agent s'arrête et demande des clarifications au lieu de deviner.

Qualité intégrée

• Tickets : critères INVEST, checklist qualité automatique
• Code : Clean Code, SOLID, OWASP, tests obligatoires
• UX : WCAG 2.2 AA, heuristiques de Nielsen

Prérequis

• Claude Code installé
• GitHub CLI (gh) configuré (pour les workflows GitHub)
• Node.js 18+

Licence

ISC

Agile-AI-Orchestrator