.NET Build Skill (Entry Map)

.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