Skip to main content
subagent CX Codex

csharp-developer · voltagent/awesome-codex-subagents — Codex subagent: what it does, how to install

csharp-developer is a Codex subagent for C# and .NET. It makes minimal fixes to APIs, service layers, and async flows while preserving contracts and architecture.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/csharp-developer.toml
Open on GitHub

What csharp-developer does

This subagent handles backend tasks across C# and .NET applications. Instead of running generic refactorings, it maps the exact boundary first: execution entry points, state paths, and external dependencies. It isolates the design gap before touching code, delivering the smallest safe change that keeps external behavior stable.

Its checks focus on async/await hygiene, CancellationToken propagation, DI registration lifetimes, and transactional boundaries around I/O. It also guards nullability annotations and DTO shapes so downstream consumers do not break. The subagent explicitly avoids rewriting unrelated layers or changing architecture unless you instruct it directly.

Every run concludes with clear reporting: the exact module path, root cause, the chosen fix with trade-offs, and residual risks requiring runtime verification.

What it helps with

  • resolve deadlocks and unhandled errors across async/await flows
  • fix DI container lifetime mismatches and service boundary issues
  • update service logic without breaking downstream DTO contracts
  • propagate CancellationToken instances through external API calls

Example prompts for the agent

  • Investigate why our async payment client causes thread pool starvation under load
  • Check our DI registrations for scoped services captured inside singletons
  • Safely propagate cancellation tokens through the order processing pipeline

How to install csharp-developer

Manually: put the files in place

.codex/agents/csharp-developer.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about csharp-developer

How to install csharp-developer in Codex?

Place the subagent definition file at .codex/agents/csharp-developer.toml in your repository.

What does the csharp-developer subagent do?

It solves C# and .NET engineering tasks across service boundaries, APIs, nullability, async logic, and DI configurations.

Does csharp-developer change the existing project structure?

No, it sticks to minimal coherent fixes and avoids refactoring unrelated layers unless explicitly requested.

Source text

csharp-developer.toml · MIT
# csharp-developer

Use when a task needs C# or .NET application work involving services, APIs, async flows, or application architecture.

Own C#/.NET tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- clear async/await behavior and cancellation token propagation
- exception handling boundaries and meaningful domain-level error surfaces
- nullability annotations and contract safety in touched APIs
- DI registration lifetimes and service boundary correctness
- I/O and persistence side effects, especially transactional boundaries
- interface and DTO shape stability for downstream consumers
- keeping implementation consistent with existing solution conventions

Quality checks:
- verify one success path and one failure path through changed service logic
- confirm async code avoids deadlocks, fire-and-forget leaks, or swallowed errors
- check nullability and mapping assumptions at interface boundaries
- ensure DI/container changes do not alter unintended runtime lifetimes
- call out migration or versioning implications if contracts changed

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not refactor unrelated layers or replace existing architectural patterns unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Backend and APIs →

csharp-developer by other authors comes first.

csharp-developer VoltAgent Community The csharp-developer subagent inspects .NET solutions and helps build C# applications, ASP.NET Core APIs, and Entity Framework Core features. Use it when async code or clean architecture is part of the task. CX Codex 276installs csharp-testing affaan-m csharp-testing — a skill that gives your agent C# and .NET testing patterns: xUnit, FluentAssertions, mocks, integration tests. CX Codex +1 6,200installs modern-csharp codewithmukesh modern-csharp teaches the agent C# 14 syntax: primary constructors, collection expressions, the field keyword, extension blocks. Useful when you write new C# or modernize old code. CX Codex +1 4,100installs csharp-refactoring dotnet csharp-refactoring is a skill for Claude Code that refactors C#/.NET code without changing behavior. It uses Roslyn bindings rather than text search for structurally correct renames and extractions. CX Codex +1 3,000installs modern-csharp-coding-standards Aaronontheweb modern-csharp-coding-standards enforces modern C# 12+ coding standards, including immutable records, pattern matching, Span<T>, zero-allocation buffers, and async best practices. CX Codex +1 2,300installs csharp-expert dotnet csharp-expert — a skill for Claude Code, Codex, Cursor and other agents that routes C# and .NET requests to the right specialist or locates the missing plugin in the dotnet/skills marketplace. CX Codex +1 2,200installs csharp-concurrency-patterns Aaronontheweb csharp-concurrency-patterns guides AI agents in selecting the right .NET concurrency abstractions, from async/await to Channels and Akka.NET. Useful when refactoring work queues and eliminating thread locks. CX Codex +1 1,600installs

From the same set176

The whole set →
elixir-expert elixir-expert — a subagent for Elixir and OTP work: processes, supervision, fault tolerance, Phoenix. Maps execution boundaries, identifies root causes, and proposes minimal safe changes. CX Codex ★ 6,505repo stars dotnet-framework-4.8-expert dotnet-framework-4.8-expert — a Codex subagent built for maintaining legacy .NET Framework 4.8 enterprise systems, config limits, and Windows-specific dependencies. CX Codex ★ 6,505repo stars dotnet-core-expert dotnet-core-expert examines .NET and ASP.NET Core work, including API behavior, middleware, hosting configuration, and cross-platform runtime effects. CX Codex ★ 6,505repo stars django-developer django-developer — a subagent for Django projects that understands models, views, forms, ORM and middleware. Takes on tasks tied to app architecture rather than checklist execution. CX Codex ★ 6,505repo stars cpp-pro cpp-pro — a C++ subagent for memory ownership, concurrency, performance-sensitive paths, and systems integration. Use it when a change needs boundary-level analysis. CX Codex ★ 6,505repo stars angular-architect angular-architect — a Codex subagent that owns Angular tasks involving component design, dependency injection, routing, signals, and enterprise application structure. CX Codex ★ 6,505repo stars websocket-engineer websocket-engineer handles WebSocket lifecycles, reconnect logic, message contracts, and state sync across unstable connections in Codex. CX Codex ★ 6,505repo stars ui-fixer The ui-fixer subagent applies small patches to reproduced UI bugs. Use it when the fix should stay close to the owning component and avoid unrelated refactoring. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open