BlakeHastings·BlakeHastings/claude-code-artifacts/aspire-dotnet-gotchas/SKILL.md

aspire-dotnet-gotchas

Skill1 starsChanged 5 months agoNo licenceView on GitHub

Hard-won gotchas building a .NET Aspire app with gRPC, a message bus, and an in-process agent, the kind that each cost a debugging session. Use when an Aspire service cannot reach another (service discovery, "No such host"), wiring gRPC between Aspire projects (HTTP/2, HTTPS, ALPN), adding RabbitMQ via Aspire (guest login fails, generated password, Not_Authorized), using MassTransit (v8 vs v9 licensing, IBus vs IPublishEndpoint, captive dependency), passing AppHost configuration or parameters (the `__` env-var separator, AddParameter from appsettings/user-secrets, where each setting should live, clone-and-run defaults, Worker SDK appsettings copy), building an agent with the Microsoft Agent Framework (Microsoft.Agents.AI, ChatClientAgent, function tools, an OpenAI-compatible/LiteLLM endpoint, CodeAct/Agent Harness providers, compacting a long-lived AgentSession), a Web SDK project hitting an ambiguous type like SessionOptions, the AppHost not seeing app types, exporting OpenTelemetry GenAI telemetry or fanning it through an OpenTelemetry Collector to the Aspire dashboard and a self-hosted Langfuse (the collector-to-dashboard host.docker.internal/TLS hop, UseOtlpExporter vs AddOtlpExporter, getting a non-.NET/polyglot container -- a Node/Python worker sidecar -- to export to the collector when WithAppForwarding skips AddDockerfile containers and the collector's OTLP receiver is HTTPS and rejects a plain-HTTP exporter, filtering the Langfuse leg by service.name, otelcol validate), grouping or pinning dashboard resources (WithParentRelationship, dashboard URL/port), or a build failing with file-locked DLLs (MSB3026/MSB3027) or a folder that will not rename. Personal companion to the vendored aspire* plugin skills (which should not be hand-edited).