Modern C# Development — Three Specialized Agents for Every Cloud Target
Vulcan è una famiglia di tre agenti specializzati per lo sviluppo C# e .NET 10 LTS, ciascuno ottimizzato per un target specifico:
| Agente | Target | File |
|---|---|---|
| Vulcan-Core | Provider-agnostic: API REST, Minimal API, gRPC, console, librerie, worker | Vulcan.Core.agent.md |
| Vulcan-AWS | AWS cloud-native: Lambda, DynamoDB, SQS, SNS, S3, ECS, CDK | Vulcan.AWS.agent.md |
| Vulcan-Azure | Azure cloud-native: Functions, Cosmos DB, Service Bus, Container Apps, Bicep | Vulcan.Azure.agent.md |
Unico formato: Agent — installabile globalmente su tutti i coding agent (Claude Code, OpenCode, GitHub Copilot, Cursor, Windsurf, Codex).
Dopo l'analisi del manifesto Vulcan v2 (47KB), abbiamo identificato che un prompt monolitico causa:
- Context window saturation: le istruzioni in fondo vengono dimenticate
- Applicazione inconsistente: regole generiche e cloud-specifiche competono
- Token sprecati: il modello processa regole AWS anche quando lavori su Azure
La soluzione: tre agenti specializzati, invocati on-demand. Ogni agente è un motore decisionale auto-sufficiente per il suo target: Core 20KB, AWS/Azure 12KB ciascuno (vs 47KB del manifesto monolitico v2).
- Architettura Adattiva — Flat, Vertical Slice, Clean Architecture, N-Tier in base alla complessità
- Cloud-Native — Pattern specifici per AWS (CDK, Lambda Powertools) e Azure (Bicep, Managed Identity)
- Minimal APIs — Default per API REST semplici, con MapGroup, IEndpointFilter, OpenAPI
- Result Pattern con OneOf — Error handling type-safe senza eccezioni
- .NET Aspire — Orchestrazione locale per progetti multi-servizio
- gRPC & IAsyncEnumerable — Streaming e comunicazione service-to-service
- Native AOT — Cold start ottimizzato per Lambda e CLI
- Observability — Serilog strutturato, OpenTelemetry, health checks
- Sicurezza — IAM Roles / Managed Identity, Key Vault, least privilege, SBOM
- Supply Chain — Central Package Management, lock file, package source mapping
curl -fsSL https://raw.githubusercontent.com/LuPaLa-Coder/Vulcan/main/install.sh | bashLo script installa tutti e tre gli agenti (Vulcan-Core, Vulcan-AWS, Vulcan-Azure) in ogni coding agent rilevato.
# Solo per Claude Code
./install.sh --agent claude
# Solo per OpenCode
./install.sh --agent opencode
# Solo per GitHub Copilot (VS Code / CLI)
./install.sh --agent copilot
# Solo per Cursor
./install.sh --agent cursor
# Solo per Windsurf
./install.sh --agent windsurf
# Solo per Codex (OpenAI)
./install.sh --agent codex
# Solo nella directory corrente (project-local)
./install.sh --local
# Disinstallazione
./install.sh --uninstallCopia i file agent nella directory del tuo tool:
| Tool | Directory Agent |
|---|---|
| Claude Code | ~/.claude/agents/ |
| OpenCode | ~/.opencode/agents/ |
| GitHub Copilot | ~/.copilot/agents/ |
| Cursor | ~/.cursor/agents/ |
| Windsurf | ~/.windsurf/agents/ |
| Codex (OpenAI) | ~/.codex/agents/ |
# Esempio per Claude Code
cp Vulcan.Core.agent.md ~/.claude/agents/
cp Vulcan.AWS.agent.md ~/.claude/agents/
cp Vulcan.Azure.agent.md ~/.claude/agents/Dopo l'installazione, Vulcan-Core, Vulcan-AWS e Vulcan-Azure appaiono nel menu agenti del tuo coding tool.
Per la guida completa, vedi Installation Guide .
-
Seleziona l'agente giusto dal menu del tuo coding tool:
- Vulcan-Core per API generiche, console app, librerie
- Vulcan-AWS per Lambda, DynamoDB, SQS, CDK
- Vulcan-Azure per Functions, Cosmos DB, Service Bus, Bicep
-
Descrivi cosa vuoi costruire:
"Crea un endpoint REST per gestire ordini con validazione,
logging strutturato e persistenza su Cosmos DB"
- Vulcan-Azure rileva il target e genera il codice completo con:
OrderController.cs(o Minimal API)OrderService.csCosmosOrderRepository.cs- Dependency injection setup
- Unit test (MSTest 3.6+/4.x) con smoke test
- Bicep per IaC
- Dockerfile + docker-compose (con Azurite)
Per esempi dettagliati, vedi Usage Guide e Examples .
Vulcan/
├── Vulcan.Core.agent.md # Agente Generic/.NET (provider-agnostic)
├── Vulcan.AWS.agent.md # Agente AWS cloud-native
├── Vulcan.Azure.agent.md # Agente Azure cloud-native
├── install.sh # Script di installazione globale (v3.1)
├── README.md
└── docs/
├── installation.md
├── usage.md
├── examples.md
├── vulcan-aws-templates.md # Boilerplate, CDK, Well-Architected AWS
└── vulcan-azure-templates.md # Boilerplate, Bicep, Best Practices Azure
- Nuove feature C# — Da specifica a codice completo production-ready
- Refactoring architetturale — Modernizzazione di codice legacy
- Cloud migration — Porta codice da on-premise a AWS/Azure
- Serverless workflows — Lambda functions, Azure Functions con pattern puliti
- API REST/gRPC — Backend completo con autenticazione e validazione
- Minimal API — API leggere con ASP.NET Core Minimal APIs
- Worker/Background jobs — Processing asincrono, message queues, event-driven
- Library & NuGet packages — Codice riutilizzabile con documentazione
- Infrastructure-as-Code — CDK (AWS) e Bicep (Azure) patterns
| Scenario | Agente |
|---|---|
| Console app, libreria, API generica, gRPC service | Vulcan-Core |
| Lambda, DynamoDB, S3, SQS, SNS, ECS, CDK | Vulcan-AWS |
| Functions, Cosmos DB, Service Bus, Container Apps, Bicep | Vulcan-Azure |
| Progetto multi-cloud o ibrido | Inizia con Vulcan-Core, poi consulta AWS/Azure per le sezioni cloud |
Ogni agente Vulcan genera:
- Codice C# completo — classi, interfacce, repository, registrazioni DI
- appsettings.json — configurazione development e production
- XML documentation — con esempi d'uso su ogni metodo pubblico
- Unit test — MSTest 3.6+/4.x con pattern moderni + smoke test obbligatori
- Dockerfile — multi-stage build + docker-compose.yml
- README.md + ARCHITECTURE.md + API.md (se applicabile)
Vulcan-AWS aggiunge: CDK Stack, SAM template, AWS-SETUP.md, IAM policies, LocalStack compose
Vulcan-Azure aggiunge: Bicep, AZURE-SETUP.md, Managed Identity config, Azurite compose
Standalone: Ogni agente Vulcan genera codice completo e indipendente.
Collaborativo: Usa Vulcan per l'implementazione e Anubis per la code review strutturata.
- Al termine di ogni sessione Vulcan produce un handoff strutturato verso Anubis
- Passa il codice generato da Vulcan ad Anubis per una review completa
- Template di handoff incluso in ogni agente
- Installation Guide — Setup e prerequisites
- Usage Guide — Workflow e comandi
- Examples — Scenari real-world
- AWS Templates — Boilerplate Lambda, CDK, Well-Architected
- Azure Templates — Boilerplate Functions, Bicep, Best Practices
- Vulcan-Core Agent — Motore decisionale Generic/.NET (20KB)
- Vulcan-AWS Agent — Motore decisionale AWS (12KB)
- Vulcan-Azure Agent — Motore decisionale Azure (12KB)
For information on other agents, see the main Agents README.