---

name: dotnet-build version: 0.2.0 kind: cli description: Build .NET solution/projects using dotnet CLI. Use when task involves compiling, restoring dependencies, or building artifacts. inputs: target: [solution, project, all] configuration: [Debug, Release] project_path: string contracts: success: 'Build completes with zero errors; artifacts in bin/' failure: 'Non-zero exit code or compilation errors'

.NET Build Skill (Entry Map)

Goal: Guide agent to the exact build procedure needed.

Quick Start (Pick One)

• Build entire solution → references/build-solution.md
• Restore dependencies only → references/restore-deps.md

When to Use

• Compile .NET code (.csproj, .sln files)
• Restore NuGet packages and dependencies
• Build Debug/Release configurations
• Generate build artifacts (binaries, assemblies)

NOT for: tests (dotnet-test), formatting (code-format), or analysis (code-analyze)

Inputs & Outputs

Inputs: target (solution/project/all), configuration (Debug/Release), project_path (default: ./dotnet/PigeonPea.sln)

Outputs: artifact_path (bin/ directory), build_log, exit code (0=success)

Guardrails: Operate in ./dotnet only, never commit bin/obj/, idempotent builds

Navigation

1. Build Entire Solution → references/build-solution.md

• First build after cloning, building before tests, creating release artifacts

2. Restore Dependencies Only → references/restore-deps.md

• Setup dev environment, fix missing packages, troubleshoot NuGet

Common Patterns

Quick Build (Debug)

Copycd ./dotnet
dotnet build PigeonPea.sln

Quick Build (Release)

Copycd ./dotnet
dotnet build PigeonPea.sln --configuration Release

Restore then Build

Copycd ./dotnet
dotnet restore PigeonPea.sln
dotnet build PigeonPea.sln --no-restore

Clean and Rebuild

Copycd ./dotnet
dotnet clean PigeonPea.sln
dotnet build PigeonPea.sln

Build Specific Project

Copycd ./dotnet
dotnet build console-app/PigeonPea.Console.csproj

Verbose Build for Debugging

Copycd ./dotnet
dotnet build PigeonPea.sln --verbosity detailed

Troubleshooting

Build fails: Check error messages. See references/build-solution.md for detailed error handling.

Missing dependencies: Run dotnet restore. See references/restore-deps.md.

NU1301 (service index): NuGet unreachable. Check references/restore-deps.md.

Slow builds: Use --no-restore, -m (parallel), or /p:RunAnalyzers=false. See references/build-solution.md.

Stale artifacts: Run dotnet clean then rebuild.

Success Indicators

CopyBuild succeeded.
    0 Warning(s)
    0 Error(s)

Artifacts in: ./dotnet/{ProjectName}/bin/{Configuration}/net9.0/

Integration

After build: dotnet-test (tests), code-analyze (static analysis) Before build: code-format (style fixes)

Related

• ./dotnet/README.md - Project structure
• ./dotnet/ARCHITECTURE.md - Architecture
• .pre-commit-config.yaml - Pre-commit hooks