AI Agent Kit

🚀 Système universel d'agents IA pour automatiser le développement logiciel avec une productivité 10x.

100+ agents spécialisés | Multi-plateforme | 60-80% d'économie de tokens

✨ Points Clés

Feature	Description
🔄 Universal	Fonctionne avec Claude, GPT, Gemini, Ollama
🌍 Multi-IDE	Claude Code, Cursor, Windsurf, Copilot, JetBrains, Neovim, Zed
📦 100+ Agents	Architect, Developer, Reviewer, Tester, Security...
⚡ Optimisé	60-80% d'économie de tokens
🔌 MCP + LSP	Protocoles standards pour intégration universelle

🚀 Installation

Installation Rapide (Recommandée)

# Linux/macOS - Détection auto + menu interactif
curl -fsSL https://raw.githubusercontent.com/krovomi/ai-agent-kit/main/scripts/installation/install | bash

# Windows (PowerShell 5.1+) - Menu interactif avec wizard
irm https://raw.githubusercontent.com/krovomi/ai-agent-kit/main/scripts/installation/install_fixed.ps1 | iex

💡 Ces commandes lancent un wizard interactif qui vous guide pour :

Choisir votre stack (dotnet, nodejs, react, angular...)

Configurer les IDE supportés (Claude Code, Cursor, Windsurf...)

Activer les serveurs MCP

Installation Locale

# Cloner le repository
git clone https://github.com/krovomi/ai-agent-kit.git
cd ai-agent-kit

# Installer
./install.sh          # Linux/macOS
./install.ps1         # Windows

Options d'Installation

# Stack spécifique
./install.sh --stack=dotnet
./install.sh --stack=nodejs
./install.sh --stack=react

# Multi-stack (fullstack)
./install.sh --stack=dotnet,react

🎯 Auto-Complétion Multi-IDE

L'AI Agent Kit génère automatiquement les fichiers de configuration pour tous les IDE/AI tools :

IDE	Fichier Généré	Syntaxe
Claude Code	`.claude/commands/*.md`	`/feature`, `@agent:architect`
Cursor	`.cursorrules`	`@agent:developer`, `@chain:backend-feature`
Windsurf	`ide-configs/windsurf/AI-SETUP.md`	`@chain:bugfix`, `@scaffold:api-dotnet`
Copilot	`.github/copilot-instructions.md`	`/feature`, `/bugfix`
Continue	`.continue/config.json`	`/backend-feature`
VS Code	`.vscode/*.code-snippets`	Snippets `@agent:`, `@chain:`
JetBrains	`.idea/templates/*.xml`	`agent_` + Tab, `chain_` + Tab
Neovim	`.nvim/lua/ai-agent-kit/`	`:AIAgents`, nvim-cmp, Telescope
Zed	`.zed/settings.json`	`/command` dans l'assistant

Régénérer les Fichiers d'Auto-Complétion

# Générer pour tous les IDE (9 plateformes)
bash scripts/completions/generate-ide-completions.sh --all

# Pour un IDE spécifique
bash scripts/completions/generate-ide-completions.sh --ide=cursor
bash scripts/completions/generate-ide-completions.sh --ide=jetbrains
bash scripts/completions/generate-ide-completions.sh --ide=neovim

Extension VS Code (Auto-complétion temps réel)

cd vscode-extension && pnpm install && pnpm run compile

Features : Auto-complétion, Hover, Go-to-Definition, Diagnostics, Quick Fix

MCP Server + LSP (Support Universel)

# MCP Server (protocole universel)
cd mcp-server && pnpm install

# LSP inclus dans l'extension VS Code

Voir docs/integrations/ide-auto-completion.md pour la configuration détaillée.

🧙 Utilisation des Agents

Syntaxe par Plateforme

# Claude Code
@architect "Concevoir une application fullstack"
@developer "Implémenter l'authentification"
@reviewer "Examiner le code"

# Cursor / Windsurf
@agent:architect "Concevoir une application fullstack"
@chain:backend-feature "Ajouter l'API utilisateur"

# CLI (PowerShell/Bash)
./agent.sh architect "Concevoir une application fullstack"
./agent.ps1 developer "Implémenter l'authentification"

Agents Principaux

Agent	Description
`architect`	Architecture logicielle (Clean Architecture, SOLID, DDD)
`developer`	Développement full-stack (.NET, React, Node.js...)
`reviewer`	Revue de code (qualité, sécurité, performance)
`unit-tester`	Tests unitaires (xUnit, Jest, pytest)
`integration-tester`	Tests d'intégration
`docwriter`	Documentation technique
`security-hardener`	Sécurité et hardening
`supabase`	Expert Supabase (PostgreSQL, Auth, RLS)

Chains (Workflows Multi-Agents)

Chain	Description
`@chain:backend-feature`	Développement feature backend complet
`@chain:frontend-feature`	Développement feature frontend
`@chain:fullstack-feature`	Développement fullstack (backend + frontend)
`@chain:bugfix`	Correction de bug avec tests
`@chain:refactor`	Refactoring avec conservation du comportement
`@chain:quickfix`	Fix rapide pour corrections triviales

Scaffolds (Génération de Projets)

# Backend
@scaffold:api-dotnet "MonProjet"
@scaffold:api-nodejs "MonProjet"
@scaffold:api-python "MonProjet"

# Frontend
@scaffold:frontend-react "MonProjet"
@scaffold:frontend-angular "MonProjet"
@scaffold:frontend-vue "MonProjet"

# Fullstack
@scaffold:fullstack "MonProjet"

🐳 Docker & Containerisation

L'AI Agent Kit inclut un système complet de dockerisation permettant de containeriser toutes vos applications et de les faire communiquer entre elles.

Wizard Docker (Configuration Guidée)

Utilisez le wizard pour configurer Docker interactivement :

# Le wizard vous guide pour :
# - Choisir le type d'application (Frontend, Backend, Fullstack, Microservices)
# - Sélectionner votre stack (React, Angular, Vue, .NET, Node.js, Python...)
# - Ajouter des services (PostgreSQL, Redis, RabbitMQ...)
# - Configurer le réseau inter-services

Dockerfiles Supportés

Stack	Description
.NET	Multi-stage build, Alpine, ASP.NET Core
Node.js	pnpm, TypeScript, multi-stage
Python	uv package manager, FastAPI/uvicorn
React	Next.js standalone, Nginx
Angular	Angular CLI, Nginx SPA
Vue	Vite, Nginx
Go	Scratch image (minimal)
Java	Spring Boot, layered jars
Rust	cargo-chef, Alpine

Docker Compose (Communication Inter-Services)

Toutes les applications peuvent communiquer via un réseau Docker bridge :

# Les services communiquent par leur nom
# Frontend → Backend : http://backend:5000
# Backend → Database : postgresql://postgres:5432

Quick Start Docker

# Démarrer tous les services
docker compose up -d

# Voir les logs
docker compose logs -f

# Arrêter
docker compose down

# Reconstruire
docker compose up -d --build

Architectures Supportées

Architecture	Fichier	Description
Single App	`docker-compose.yaml`	Une seule application
Fullstack	`docker-compose.fullstack.yaml`	Frontend + Backend + DB
Microservices	`docker-compose.microservices.yaml`	Multiple services avec service discovery

Services Additionnels Inclus

Databases : PostgreSQL, MySQL, MongoDB
Cache : Redis
Message Queue : RabbitMQ
Search : Elasticsearch
Storage : MinIO (S3-compatible)
Dev Tools : MailHog (email testing)

👉 Documentation complète : Voir docs/integrations/docker.md

📁 Structure du Projet

ai-agent-kit/
├── install.sh/ps1              # Points d'entrée installation
├── .ai-agents/                  # Bibliothèque d'agents (100+)
│   ├── agents/                  # Définitions des agents
│   ├── chains/                  # Workflows multi-agents
│   ├── scaffolds/               # Templates de projets
│   ├── skills/                  # Compétences réutilisables
│   ├── contexts/                # Configurations par stack
│   ├── wizards/                 # Wizards de configuration
│   └── registry/                # Manifest des composants
├── templates/                   # Templates de génération
│   ├── docker/                  # Dockerfiles & docker-compose
│   └── fullstack/               # Templates fullstack
├── .claude/                     # Configuration Claude Code
├── ide-configs/                 # Configurations IDE
│   ├── jetbrains/               # Templates JetBrains
│   └── windsurf/                # Configuration Windsurf (AI-SETUP.md)
├── .nvim/                       # Plugin Neovim (Lua)
├── .zed/                        # Configuration Zed Editor
├── mcp-server/                  # Serveur MCP universel
├── vscode-extension/            # Extension VS Code + LSP
├── scripts/                     # Scripts utilitaires
│   ├── installation/            # Installateurs multi-plateformes
│   ├── completions/             # Générateurs auto-complétion
│   └── validation/              # Scripts de validation
└── docs/                        # Documentation (organisée par thèmes)
    ├── getting-started/         # Installation et démarrage
    ├── guides/                  # Guides pratiques
    ├── reference/               # Références techniques
    ├── architecture/            # Architecture système
    ├── integrations/            # Intégrations et MCP
    ├── stacks/                  # Guides par technologie
    ├── security/                # Documentation sécurité
    ├── troubleshooting/         # Dépannage
    ├── advanced/                # Fonctionnalités avancées
    └── migration/               # Guides de migration

🏗️ Stacks Supportés

Backend

Stack	Agents Spécialisés
.NET 10	`dotnet-developer`, `dotnet-architect`, `dotnet-tester`
Node.js 25	`nodejs-architect`, `nodejs-tester`
Python 3.13	`python-developer`, `python-architect`
Go	`go-developer`, `go-architect`
Java	`java-developer`, `java-architect`
Rust	`rust-developer`, `rust-architect`

Frontend

Stack	Agents Spécialisés
React 19	`react-developer`, `react-component-builder`
Angular 21	`angular-developer`, `angular-component-builder`
Vue.js	`vue-developer`, `vue-component-builder`
Svelte	`svelte-developer`
Next.js	`nextjs-developer`

Base de Données

Stack	Support
PostgreSQL	Via agent `supabase`
Supabase	Auth, RLS, Migrations, Edge Functions
SQL Server	Via agents .NET

⚠️ .NET Policy: Minimal APIs Only

Tous les agents .NET génèrent exclusivement des Minimal APIs. Les Controllers sont INTERDITS.

✅ Pattern Requis (.NET)

// ✅ CORRECT - Minimal API
namespace Api.Endpoints;

public static class UsersEndpoints
{
    public static void MapUsersEndpoints(this IEndpointRouteBuilder app)
    {
        var group = app.MapGroup("/api/users").WithTags("Users");
        
        group.MapGet("/", async (IUserService service) =>
            Results.Ok(await service.GetUsersListAsync()));
            
        group.MapPost("/", async (CreateUserDto dto, IUserService service) =>
        {
            var result = await service.CreateAsync(dto);
            return Results.CreatedAtRoute("GetUserById", new { id = result.Id }, result);
        });
    }
}

❌ Pattern Interdit (.NET)

// ❌ INTERDIT - Controllers (deprecated)
[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    // DO NOT GENERATE THIS
}

📖 Documentation Complète

Politique : docs/stacks/dotnet-minimal-apis-policy.md
Guide de Migration : docs/stacks/dotnet-controller-migration.md
Patterns Détaillés : templates/dotnet/.claude/context/minimal-api-patterns.md

🔌 Configuration MCP (Model Context Protocol)

L'AI Agent Kit intègre une configuration complète du Model Context Protocol pour connecter les agents IA à votre IDE.

📍 Fichiers de Configuration

Voir le dossier .ai/mcp/ pour :

mcp.json - Configuration principale (6 serveurs MCP)
Guides de configuration - Pour Claude Desktop, Cursor, Windsurf
Scripts de validation - Vérifier votre installation

Installation Rapide

# Configuration automatique
node scripts/installation/mcp-auto-setup.js

# Ou copier manuellement :
cp .ai/mcp/mcp.json ~/.claude/mcp.json    # Claude Desktop
cp .ai/mcp/mcp.json ~/.cursor/mcp.json    # Cursor
cp .ai/mcp/mcp.json ~/.windsurf/mcp.json  # Windsurf

Commandes Disponibles

Une fois configuré, utilisez dans votre IDE :

/feature              Développement de feature
/bug-fix              Correction de bug
/refactor             Refactorisation
/test                 Écriture de tests
/review               Revue de code
/security             Audit de sécurité

👉 Documentation complète : Voir .ai/mcp/README.md

Profiles MCP

Les profiles MCP chargent automatiquement les serveurs nécessaires selon le workflow :

Profile	Serveurs	Économie
`minimal`	git, filesystem	83%
`standard`	+ github, playwright	50%
`full`	Tous les serveurs	0%
`backend-only`	git, filesystem, github	67%
`frontend-react`	+ browser-tools	50%

# Configuration automatique
./scripts/installation/mcp-auto-setup.sh --profile standard

📖 Documentation

Guide	Description
Installation	Guide d'installation détaillé
Auto-Complétion	Configuration par IDE
Agents	Liste complète des agents
Chains	Workflows disponibles
Docker	Containerisation des applications
MCP	Configuration des serveurs MCP

🛠️ Scripts Utilitaires

# Régénérer le manifest des composants
python3 scripts/completions/generate-manifest.py

# Régénérer les fichiers d'auto-complétion
bash scripts/completions/generate-ide-completions.sh --all

# Configuration MCP automatique
./scripts/installation/mcp-auto-setup.sh

# Validation YAML
./scripts/validation/validate-yaml.sh

💡 Exemples d'Utilisation

Nouvelle Feature Backend

# 1. Design architecture
@architect "API REST pour gestion utilisateurs avec JWT"

# 2. Implémentation
@chain:backend-feature "Implémenter l'API utilisateurs"

# 3. Le workflow exécute automatiquement :
#    architect → developer → unit-tester → integration-tester → reviewer → docwriter

Correction de Bug

@chain:bugfix "Fix: NullReferenceException dans UserService.GetById"

Projet Fullstack

# Générer le scaffold
@scaffold:fullstack "ecommerce-app"

# Développer une feature
@chain:fullstack-feature "Ajouter panier d'achat avec persistance"

Traitement Automatique de Tickets Azure DevOps

# Traiter tous les tickets fils d'un parent Azure DevOps
@chain:azure-devops-parent-processor --parent-id 586655

⚠️ Note : L'option --auto-complete-prs est désactivée par défaut (review humaine requise). Les PRs sont créées en attente de validation.

Ce workflow automatise :

✅ Récupération des tickets fils via MCP Azure DevOps
✅ Implémentation avec agents appropriés (dotnet-developer, etc.)
✅ Tests automatiques (>80% coverage)
✅ Création et push de PR pour chaque ticket
✅ Synchronisation des statuts Azure DevOps ("Resolved")
✅ Commentaires détaillés sur chaque ticket
✅ Rapport récapitulatif sur le ticket parent

📖 Documentation :

Guide Complet Azure DevOps - Tout en un fichier (Quick Start + Prompts + Configuration)
Guide Technique Détaillé - Pour les cas avancés

🤝 Contribuer

Fork le repository
Créer une branche (git checkout -b feature/ma-feature)
Commit (git commit -m 'feat: Ajouter ma feature')
Push (git push origin feature/ma-feature)
Ouvrir une Pull Request

📄 License

MIT License - voir LICENSE pour plus de détails.

AI Agent Kit - Automatisez votre développement avec l'IA
GitHub • Documentation • Issues

Name		Name	Last commit message	Last commit date
Latest commit History 444 Commits
.ai-agents		.ai-agents
.ai/mcp		.ai/mcp
.claude		.claude
.continue		.continue
.github		.github
.nvim		.nvim
.zed		.zed
docs		docs
ide-configs		ide-configs
logs		logs
mcp-server		mcp-server
scripts		scripts
templates		templates
tests		tests
vscode-extension		vscode-extension
.ai-agents.yaml		.ai-agents.yaml
.cursorrules		.cursorrules
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.secrets.baseline		.secrets.baseline
.yamllint.yml		.yamllint.yml
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
FIX-SESSION-START-HOOK.md		FIX-SESSION-START-HOOK.md
LICENSE		LICENSE
README.md		README.md
install.ps1		install.ps1
install.sh		install.sh
package.json		package.json
pytest.ini		pytest.ini
quick-install.sh		quick-install.sh

Folders and files

Latest commit

History

Repository files navigation

AI Agent Kit

✨ Points Clés

🚀 Installation

Installation Rapide (Recommandée)

Installation Locale

Options d'Installation

🎯 Auto-Complétion Multi-IDE

Régénérer les Fichiers d'Auto-Complétion

Extension VS Code (Auto-complétion temps réel)

MCP Server + LSP (Support Universel)

🧙 Utilisation des Agents

Syntaxe par Plateforme

Agents Principaux

Chains (Workflows Multi-Agents)

Scaffolds (Génération de Projets)

🐳 Docker & Containerisation

Wizard Docker (Configuration Guidée)

Dockerfiles Supportés

Docker Compose (Communication Inter-Services)

Quick Start Docker

Architectures Supportées

Services Additionnels Inclus

📁 Structure du Projet

🏗️ Stacks Supportés

Backend

Frontend

Base de Données

⚠️ .NET Policy: Minimal APIs Only

✅ Pattern Requis (.NET)

❌ Pattern Interdit (.NET)

📖 Documentation Complète

🔌 Configuration MCP (Model Context Protocol)

📍 Fichiers de Configuration

Installation Rapide

Commandes Disponibles

Profiles MCP

📖 Documentation

🛠️ Scripts Utilitaires

💡 Exemples d'Utilisation

Nouvelle Feature Backend

Correction de Bug

Projet Fullstack

Traitement Automatique de Tickets Azure DevOps

🤝 Contribuer

📄 License

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages