Build Backend Skill

Use this skill to validate that all backend C# projects compile successfully without errors.

What This Skill Does

1. Runs dotnet build to compile all .NET projects in the solution
2. Captures and parses compilation errors
3. Reports errors with file and line number references
4. Exits with failure status if any compilation errors are found

When to Use

• After implementing backend features in the Api project, Application project, or Worker project
• To validate that dependencies and package versions are correct
• Before running tests or other downstream validation steps
• To catch syntax errors or type mismatches early

How the Agent Should Use This Skill

1. Prepare: Ensure you are in the repository root directory
2. Invoke: Run the backend build helper script from the repository root:

   dotnet .github/skills/build-backend/build-backend.cs
   

3. Parse Output: Monitor stdout for success message and stderr for errors
4. Handle Errors: If exit code is non-zero, the build failed. Review the error messages to identify:
   • File paths and line numbers from error output
   • Type errors, syntax errors, or missing references
   • Package version conflicts
5. Report: If any errors occur, halt further validation and report the compilation error details to the user

Success Criteria

• Exit code: 0
• Stdout contains: [BUILD] Backend build completed successfully

Failure Indicators

• Exit code: 1
• Stderr contains compilation errors (e.g., error CS0103: The name 'xyz' does not exist)
• Stdout/stderr may contain file paths and line numbers of errors

Notes

• The build script automatically finds the repository root by searching for FakeSurveyGenerator.slnx or FakeSurveyGenerator.sln
• Full build output is captured; review stderr for detailed error messages
• Backend projects are: Api, Application, Application.Tests, Api.Tests.Integration, Worker, ServiceDefaults, Proxy

Next Steps After Success

Once backend build succeeds, typically invoke:

• Frontend Build Skill – to compile TypeScript
• Test Backend Units Skill – to run unit and integration tests