Ln 722 Backend Generator

Generates .NET Clean Architecture backend structure from entity definitions

majiayu000 Updated Sep 22, 2026 567 repo stars

Coding & Dev Tools

Install

Press C to copy

$ npx skillmds@latest add majiayu000/ln-722-backend-generator-5

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

＋ Add to plugin

README badge

[![SkillMD](https://skillmd.com/badge/majiayu000/ln-722-backend-generator-5.svg)](https://skillmd.com/skills/majiayu000/ln-722-backend-generator-5)

Trust & safety

2 of 3 audits passed

Last audited Sep 23, 2026 · commit abd0a35

Permissions this skill uses

Documentation only
No scripts, network access, or credentials are involved.

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

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.

ln-722-backend-generator

Type: L3 Worker Category: 7XX Project Bootstrap Parent: ln-720-structure-migrator

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

---name: ln-722-backend-generator-5description: Generates .NET Clean Architecture backend structure from entity definitions---> **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.# ln-722-backend-generator**Type:** L3 Worker**Category:** 7XX Project Bootstrap**Parent:** ln-720-structure-migratorGenerates 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 ContextAccept 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 SolutionGenerate 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 DomainCreate 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 APICreate 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: VerifyValidate 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

majiayu000/claude-skill-registry-data/tree/main/development/ln-722-backend-generator-cbbkrd-tech-jl-finishes commit abd0a35e9e

Frequently asked questions

npx skillmds@latest add majiayu000/ln-722-backend-generator-5