---

name: csharp-init description: > Initialize .NET project with C# 14 standards configuration. Creates Directory.Build.props, Directory.Packages.props, .editorconfig, BannedSymbols.txt, and Makefile. Use for "/init" or "setup project". user-invocable: true allowed-tools:

• Read
• Write
• Bash
• Glob
• AskUserQuestion metadata: author: csharp-standards version: "3.0.0"

---

Project Initialization

Initialize a .NET project with modern C# 14 / .NET 10 standards configuration.

Files Created

Workflow

Step 1: Check Existing Files

Copyls -la Directory.Build.props Directory.Packages.props .editorconfig BannedSymbols.txt Makefile 2>/dev/null

If files exist, ask user whether to overwrite or skip.

Step 2: Copy Templates

Templates are in templates/ directory. Copy each file to repository root.

Copy# Example for each file
cp templates/Directory.Build.props ./
cp templates/Directory.Packages.props ./
cp templates/.editorconfig ./
cp templates/BannedSymbols.txt ./
cp templates/Makefile ./

Step 3: Restore and Build

Copydotnet restore
dotnet build

Step 4: Commit Changes (if requested)

Copygit add Directory.Build.props Directory.Packages.props .editorconfig BannedSymbols.txt Makefile
git commit -m "feat: add C# 14 standards configuration"

Template Overview

Directory.Build.props

Key settings applied to ALL projects:

Copy<!-- C# Language -->
<LangVersion>preview</LangVersion>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>

<!-- Strict Analysis -->
<AnalysisLevel>latest-all</AnalysisLevel>
<AnalysisMode>All</AnalysisMode>
<WarningLevel>9999</WarningLevel>
<EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>

<!-- AOT-Readiness -->
<EnableTrimAnalyzer>true</EnableTrimAnalyzer>
<EnableSingleFileAnalyzer>true</EnableSingleFileAnalyzer>

<!-- Unified Output -->
<UseArtifactsOutput>true</UseArtifactsOutput>

<!-- NuGet Security -->
<NuGetAudit>true</NuGetAudit>
<NuGetAuditLevel>moderate</NuGetAuditLevel>

<!-- Reproducible Builds -->
<RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>

Analyzers included:

• Roslynator.Analyzers
• SonarAnalyzer.CSharp
• Microsoft.CodeAnalysis.BannedApiAnalyzers
• Microsoft.VisualStudio.Threading.Analyzers

Directory.Packages.props

Central Package Management (CPM) for version control:

Copy<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>

Pre-configured versions for:

• Analyzers
• Testing (xUnit, Shouldly, NSubstitute)
• Microsoft.Extensions.*
• EF Core
• ErrorOr

.editorconfig

Code style enforcement:

• K&R brace style (csharp_new_line_before_open_brace = none)
• File-scoped namespaces
• var for obvious types
• Naming conventions (PascalCase, _camelCase for fields)

BannedSymbols.txt

Forbidden APIs:

• DateTime.Now → use TimeProvider
• DateTime.UtcNow → use TimeProvider
• Thread.Sleep → use Task.Delay
• Task.Result → use await
• Task.Wait → use await

Makefile

Standard targets:

• make build — build solution
• make test — run tests
• make lint — check formatting
• make fix — auto-fix issues
• make up — docker compose up
• make down — docker compose down

Post-Init Checklist

After initialization, verify:

1. dotnet build succeeds with no errors
2. dotnet format --verify-no-changes passes
3. All projects use CPM (no Version= in PackageReference)
4. packages.lock.json files generated and committed

Customization

Add Project-Specific Packages

Edit Directory.Packages.props:

Copy<ItemGroup Label="MyProject">
  <PackageVersion Include="SomePackage" Version="1.0.0" />
</ItemGroup>

Suppress Specific Warnings

Edit .editorconfig:

Copy# Suppress specific warning in specific files
[**/Migrations/*.cs]
dotnet_diagnostic.CA1062.severity = none