.NET Profiling

.NET Profiling

Trigger On

• the repo needs performance or runtime profiling for a .NET application
• the user asks about slow code, high CPU, GC pressure, allocation growth, exception storms, lock contention, or startup diagnostics
• the team wants official CLI-based diagnostics without depending on dnx

Value

• produce a concrete project delta: code, docs, config, tests, CI, or review artifact
• reduce ambiguity through explicit planning, verification, and final validation skills
• leave reusable project context so future tasks are faster and safer

Do Not Use For

• replacing realistic performance tests or load tests with ad-hoc tracing alone
• production heap collection when the pause risk has not been accepted
• GUI-only workflows that the repo cannot automate or document

Inputs

• the nearest AGENTS.md
• target application, process, or startup path
• the symptom being investigated: CPU, memory, GC, contention, exceptions, or startup

Quick Start

1. Read the nearest AGENTS.md and confirm scope and constraints.
2. Run this skill's Workflow through the Ralph Loop until outcomes are acceptable.
3. Return the Required Result Format with concrete artifacts and verification evidence.

Workflow

1. Build and run a realistic target first:
   • prefer Release
   • prefer realistic config, inputs, and data volume
2. Start with the lightest useful tool:
   • dotnet-counters for live health signals
   • dotnet-trace for CPU, exception, contention, GC, and startup traces