cbbkrd-tech/ln-722-backend-generator

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