Paths: File paths (shared/ , references/ , ../ln-* ) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root. If shared/ is missing, fetch files via WebFetch from https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path} .

ln-722-backend-generator

Type: L3 Worker Category: 7XX Project Bootstrap

Generates complete .NET backend structure following Clean Architecture principles.

Purpose & Scope

Aspect Description

Input Project name, entity list, configuration options

Output Complete .NET solution with layered architecture

Target .NET 10+, ASP.NET Core

Scope boundaries:

• Generates project structure and boilerplate code

• Creates MockData for initial development

• Does not implement business logic or database connections

Workflow

Phase Name Actions Output

1 Receive Context Get project name, entities, options from coordinator Configuration

2 Create Solution Create .sln and .csproj files Empty solution structure

3 Generate Domain Create entities, enums, base classes Domain project files

4 Generate API Create controllers, DTOs, middleware API project files

5 Verify Build solution, check references Build success

Phase 1: Receive Context

Accept delegation from ln-720-structure-migrator.

Input Type Required Description

projectName

string Yes Solution and project name prefix

targetPath

string Yes Directory for generated solution

targetFramework

string Yes .NET version (e.g., net10.0)

entities

list Yes Entity names to generate

features

list Yes Feature groupings for MockData

Options:

Option Default Effect

useSwagger

true Add Swashbuckle for API docs

useSerilog

true Add structured logging

useHealthChecks

true Add health endpoints

createMockData

true Generate mock data classes

Phase 2: Create Solution

Generate solution file and project structure.

Step Action Reference

2.1 Create solution directory —

2.2 Generate .sln file —

2.3 Create project directories layer_structure.md

2.4 Generate .csproj files per layer layer_structure.md

2.5 Add project references layer_structure.md

Generated projects:

Project Purpose

{Project}.Api

HTTP endpoints, middleware

{Project}.Domain

Entities, enums

{Project}.Services

Business logic interfaces

{Project}.Repositories

Data access interfaces

{Project}.Shared

Cross-cutting utilities

Phase 3: Generate Domain

Create domain layer files.

Step Action Reference

3.1 Create BaseEntity class entity_patterns.md

3.2 Generate entity classes per input entity_patterns.md

3.3 Generate status enums entity_patterns.md

3.4 Create folder structure layer_structure.md

Entity generation rules:

Entity Property Generated As

Primary key public Guid Id { get; set; }

String field public string Name { get; set; } = string.Empty;

Status field public {Entity}Status Status { get; set; }

Timestamps CreatedAt , UpdatedAt from BaseEntity

Phase 4: Generate API

Create API layer files.

Step Action Reference

4.1 Generate Program.cs program_sections.md

4.2 Generate controllers per entity controller_patterns.md

4.3 Generate DTOs per entity controller_patterns.md

4.4 Generate middleware classes layer_structure.md

4.5 Generate extension methods program_sections.md

4.6 Generate MockData classes (if enabled) layer_structure.md

4.7 Add NuGet packages nuget_packages.md

Controller endpoints per entity:

Endpoint Method Route

GetAll GET /api/{entities}

GetById GET /api/{entities}/{id}

Create POST /api/{entities}

Update PUT /api/{entities}/{id}

Delete DELETE /api/{entities}/{id}

Phase 5: Verify

Validate generated solution.

Check Command Expected

Solution builds dotnet build

Success, no errors

Project references Check .csproj All references valid

Files created Directory listing All expected files present

Generated Structure Summary

Layer Folders Files per Entity

Api Controllers/, DTOs/, Middleware/, MockData/, Extensions/ Controller, DTO

Domain Entities/, Enums/, Common/ Entity, Status enum

Services Interfaces/ Interface (stub)

Repositories Interfaces/ Interface (stub)

Shared — Utility classes

Critical Rules

• Single Responsibility: Generate only backend structure, no frontend

• Idempotent: Can re-run to regenerate (will overwrite)

• Build Verification: Must verify dotnet build passes

• Clean Architecture: Respect layer dependencies (inner layers independent)

• No Business Logic: Generate structure only, not implementation

• MockData First: Enable immediate API testing without database

Definition of Done

• Solution file created with all projects

• All project references configured correctly

• Domain entities generated for all input entities

• Controllers generated with CRUD endpoints

• DTOs generated for request/response

• MockData classes generated (if enabled)

• Program.cs configured with all services

• dotnet build passes successfully

• Swagger UI accessible (if enabled)

Risk Mitigation

Risk Detection Mitigation

Build failure dotnet build fails Check .csproj references, verify SDK version

Missing references CS0246 errors Add missing project references

Invalid entity names Build or runtime errors Validate entity names before generation

Path conflicts File exists errors Check target path, prompt before overwrite

Package restore failure NuGet errors Verify network, check package names

Reference Files

File Purpose

references/layer_structure.md

Project organization, folder structure, dependencies

references/entity_patterns.md

Entity generation rules, property patterns

references/controller_patterns.md

Controller and DTO generation rules

references/program_sections.md

Program.cs structure and service registration

references/nuget_packages.md

Required and optional NuGet packages

Version: 2.0.0 Last Updated: 2026-01-10