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

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

dotnet-build