ElBruno.AgentsOrchestration.Core 0.5.5

Agents Orchestration — Multi-Agent Orchestration Libraries

A .NET 10 library suite inspired by Burke Holland's "Ultralight Orchestration" video, implementing the pattern in production-ready C#, using Microsoft Agent Framework and GitHub Copilot SDK to create a powerful multi-agent orchestration system.

Build software automatically using a coordinated team of 11 specialized AI agents—including Orchestrator, Planner, Coder, Designer, Researcher, Fixer, BuildReviewer, SecurityExpert, TestingExpert, DocumentationExpert, and SoftwareArchitect—that work together to execute your prompts.

✨ New: Dynamic Agent Loading

Load specialized agents from the Awesome Copilot Repository at runtime! Extend your orchestration with domain-specific experts like:

• WinForms Expert for Windows Forms development
• Security Reviewer for OWASP Top 10 and LLM security
• Any custom agent you create or find in the community

See AddAndListCustomAgents sample to load custom agents, or ConsoleWinFormsGenerator to see agents generating applications.

🚀 See It in Action

Overview

The libraries provide a production-ready orchestration engine with:

• 11 specialized AI agents powered by GitHub Copilot SDK — 6 core agents for the orchestration pipeline and 5 specialist agents for extended capabilities (security, testing, documentation, architecture, research)
• GitHub Copilot integration — all agents leverage the GitHub Copilot SDK for intelligent code generation, analysis, and planning
• Research capabilities — the Researcher agent leverages web search and documentation (Microsoft Learn, Context7) to provide external knowledge
• Inter-agent communication — agents can request research and receive enriched context for better results
• Flow tracing and visualization — track all agent interactions with Mermaid diagrams and JSON flow data
• Build validation & self-healing — automatically detects build errors and invokes the Fixer agent to correct them
• Build quality analysis — BuildReviewer analyzes successful builds to provide feedback on performance, security, and best practices
• Event streaming — real-time event channel (21 event types) for monitoring orchestration progress
• Pluggable agent clients — swap any LLM backend (template, Copilot, OpenAI, Claude, etc.)
• Workspace isolation — each run gets a timestamped directory with automatic cleanup
• .NET Aspire ready — full support for service discovery, health checks, and distributed tracing
• OpenTelemetry built-in — metrics, logs, and traces for production monitoring

Quick Links

• 📚 Getting Started — Step-by-step guide with sample prompts
• 🏗️ Architecture — Design patterns and library structure
• 📦 Library Packages — Core abstractions, orchestration engine, and complete toolkit
• 🤖 All Agents — Complete guide to all 11 agents and their roles
• 🔎 Researcher Agent — Complete guide to the research agent and inter-agent communication
• 📖 Using the Libraries — How to integrate into your own projects
• 🎯 Samples Overview — Complete guide to all six samples
• 💡 Samples — Six ready-to-run examples:
  • ConsoleSimple — Minimal demo (weather app)
  • ConsoleCompleteChat — Full interactive multi-turn chat
  • ConsoleFlowTraces — Flow tracing and call graph visualization
  • AddAndListCustomAgents — Load custom agents from the community
  • ConsoleWinFormsGenerator — Generate WinForms applications using dynamic agents
  • AspireApp — Production-grade Blazor dashboard with REST API

Installation

dotnet add package ElBruno.AgentsOrchestration.Core

The package includes all three libraries (Abstractions, Orchestration, Core) and is powered by the GitHub Copilot SDK for agent intelligence.

Quick Start

Here's the minimal code to run an orchestration:

using ElBruno.AgentsOrchestration.Core.Orchestration;
using ElBruno.AgentsOrchestration.Orchestration;

// Create service and run (that's it!)
var service = OrchestrationServiceFactory.Create();
var result = await service.RunAsync(
    new OrchestrationRequest("Create a .NET weather console app"),
    CancellationToken.None
);

Console.WriteLine($"✅ Done! Files: {result.WorkspacePath}");
Console.WriteLine($"Summary: {result.Summary}");

With custom configuration:

var service = OrchestrationServiceFactory.Create(options =>
{
    options.WorkspaceRoot = "custom-path";
    options.MaxFixAttempts = 5;
});

For ASP.NET Core / Aspire apps (Dependency Injection):

// In Program.cs
builder.Services.AddOrchestration(options =>
{
    options.WorkspaceRoot = "workspaces";
    options.MaxFixAttempts = 3;
});

// With dynamic agent support
builder.Services.AddDynamicAgents(options =>
{
    options.CacheDirectory = "./agent-cache";
    options.CacheExpirationHours = 24;
});

// Then inject
public class MyController
{
    private readonly OrchestrationService _service;
    private readonly DynamicAgentManager _agentManager;
    
    public MyController(OrchestrationService service, DynamicAgentManager agentManager)
    {
        _service = service;
        _agentManager = agentManager;
    }
    
    public async Task LoadSpecializedAgent()
    {
        await _agentManager.LoadAndRegisterAgentAsync("WinFormsExpert");
    }
}

See ConsoleSimple for the complete 6-step walkthrough, AddAndListCustomAgents for dynamic agent loading, ConsoleWinFormsGenerator for application generation, and Getting Started for detailed usage.

Six-Step Pipeline

Testing

dotnet test

40+ tests cover agents, orchestration, workspace operations, and security.

🎬 Stay Updated & Connect

Love this library? Want to see how to use it in action? Check out my content across the web:

🚀 Follow the Journey

• 💻 GitHub — Explore all my projects and contributions
• 📝 Blog — Deep dives into AI, orchestration, and .NET development
• 🎙️ Podcast — Tech talks and interviews (Spanish 🇪🇸)
• ▶️ YouTube — Video tutorials and live coding sessions
• 💼 LinkedIn — Professional insights and updates
• 𝕏 Twitter/X — Quick tips, updates, and community engagement

Star ⭐ this repo if you find it helpful, and share it with your team!

👋 About the Author

Hi! I'm ElBruno, a software architect and AI enthusiast passionate about building production-grade orchestration systems. I create tools that help developers leverage AI agents to automate complex workflows.

If you have questions, feedback, or want to chat about this project—hit me up on any of the platforms above! 🤝

License

Copyright © ElBruno — All rights reserved.