nt8-sdk/docs/02-runbooks/compile_error_triage_workflow.md

Compile Error Triage Workflow

Purpose

Resolve compile errors quickly using smallest-safe changes and durable prevention notes.

Inputs

• Failing command output (./verify-build.bat or dotnet test).
• File scope constraints for current task.

Steps

1. Reproduce with the same command to confirm current error set.
2. Classify each error:
   • missing type/namespace,
   • bad override/signature,
   • wrong overload/argument,
   • C# 5.0 compatibility violation.
3. Verify any NinjaScript/API signatures against NT8 docs before editing.
4. Apply minimum-diff fix in scoped files only.
5. Re-run ./verify-build.bat.
6. Run focused tests for the impacted area.
7. If issue is non-trivial, add concise prevention notes to governance docs.

Required Output

• Error-to-fix mapping (error code, root cause, fix).
• Verification evidence (build/test commands and results).

Exit Criteria

• Build passes.
• Relevant tests pass.
• Non-trivial learnings are captured.