.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)

cd ./dotnet dotnet build PigeonPea.sln

Quick Build (Release)

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

Restore then Build

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

Clean and Rebuild

cd ./dotnet dotnet clean PigeonPea.sln dotnet build PigeonPea.sln

Build Specific Project

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

Verbose Build for Debugging

cd ./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

Build 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