Nuke Build Skill (Entry Map)

Goal: Guide agent to execute Nuke build targets and orchestrate build workflows.

Quick Start (Pick One)

• Run build targets → references/build-targets.md
• Setup Nuke in new project → references/setup-nuke.md

When to Use

• Execute Nuke build targets (Clean, Restore, Compile)
• Orchestrate complex build workflows
• Run cross-platform builds with unified interface
• Manage build pipelines and dependencies
• Integrate with CI/CD systems

NOT for: Simple .NET builds (use dotnet-build), testing (dotnet-test), or formatting (code-format)

Inputs & Outputs

Inputs: target (Clean/Restore/Compile), configuration (Debug/Release), parameters (custom build parameters)

Outputs: Build artifacts, target execution logs, exit code (0=success)

Guardrails: Execute from ./build/nuke directory, verify targets exist, never commit build artifacts

Navigation

1. Run Build Targets → `references/build-targets.md`

• Execute Clean, Restore, Compile targets
• Pass custom parameters to build
• Run multiple targets in sequence

2. Setup Nuke → `references/setup-nuke.md`

• Bootstrap Nuke in existing project
• Configure build targets and dependencies
• Set up CI/CD integration

Common Patterns

Run Default Target (Compile)

cd ./build/nuke
./build.sh

Run Specific Target

cd ./build/nuke
./build.sh Clean
./build.sh Restore
./build.sh Compile

Run with Configuration

cd ./build/nuke
./build.sh Compile --configuration Release

Run Multiple Targets

cd ./build/nuke
./build.sh Clean Restore Compile

Windows (PowerShell)

cd ./build/nuke
./build.ps1 Compile

Windows (Command Prompt)

cd build\nuke
build.cmd Compile

Cross-Platform Build

# Linux/macOS
./build/nuke/build.sh Compile --configuration Release

# Windows
.\build\nuke\build.ps1 Compile --configuration Release

Troubleshooting

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

Script not executable: Run chmod +x build.sh on Linux/macOS.

Missing .NET SDK: Install .NET SDK 8.0 or later. Build scripts will attempt to download if missing.

Target not found: Check available targets with ./build.sh --help or see references/build-targets.md.

Compilation errors: Nuke build uses MSBuild under the hood. Check Build.cs for target implementation.

Success Indicators

═══════════════════════════════
Target             Status      Duration
───────────────────────────────
Restore            ✓          00:00:02
Compile            ✓          00:00:05
───────────────────────────────
Build succeeded
═══════════════════════════════

Build artifacts in: ./build/nuke/build/bin/

Integration

Complements dotnet-build: Nuke orchestrates higher-level workflows; dotnet-build handles direct .NET compilation After build: dotnet-test (tests), code-analyze (static analysis) Before build: code-format (style fixes)

Nuke vs. dotnet CLI

When to use Nuke: Complex builds, CI/CD pipelines, multi-project orchestration When to use dotnet: Simple builds, quick compilation, local development

Related

• `./build/nuke/build/Build.cs` - Build target definitions
• `./build/nuke/build/_build.csproj` - Build project
• `.agent/skills/dotnet-build/` - Direct .NET build skill
• Nuke documentation - Official Nuke docs

Available Targets

Current project targets (see Build.cs):

• Clean: Removes build artifacts and output directories
• Restore: Restores NuGet dependencies
• Compile: Compiles the solution (default target)

Target dependencies:

• Compile → Restore
• Clean → (runs before Restore)