CI Failure Triage

When to Use This Skill

Use when pipeline runs fail or when pre-merge checks are unstable.

Primary target in this repository:

• •azure-pipelines.yml stage/job: Validate / node_api_validation

Triage Workflow

1. •Identify the failed step and error signature.
2. •Reproduce locally with the same command.
3. •Classify root cause and apply minimal fix.
4. •Re-run affected checks and ensure no regressions.
5. •Update root README.md if workflow expectations changed.

Step-Specific Playbook

• •

  Install dependencies (npm ci):

  • •Verify lockfile is committed and in sync.
  • •Check Node version mismatch and registry/network issues.
• •

  Unit tests with coverage (npm test ...coverageReporters...):

  • •Fix failing tests first, then coverage thresholds.
  • •Avoid weakening thresholds unless explicitly required.
• •

  Compose validation (docker compose config):

  • •Check YAML syntax and service field consistency.
  • •Validate command/healthcheck entries.
• •

  Helm render (helm template ...):

  • •Check template/values key mismatches.
  • •Validate selectors, ports, probes, and required values.

See CI failure signatures for common patterns and remediations.