# CI Failure Triage

> Use when local or CI checks fail to quickly classify root cause and apply a minimal safe fix.

- Skill: `meshtastic/ci-failure-triage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add meshtastic/ci-failure-triage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/meshtastic/ci-failure-triage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: meshtastic (https://skillmd.com/u/meshtastic)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/meshtastic/ci-failure-triage

---


# CI Failure Triage

Use this skill when local or CI checks fail.

## Goals
- Find root cause quickly.
- Apply minimal safe fix.
- Revalidate only necessary scopes first.

## Required Context
- AGENTS.md
- CONTRIBUTING.md
- docs/ci-cd.md
- docs/versioning.md

## Triage Buckets
- Build setup or dependency issues.
- Lint or formatting failures.
- Architecture rule failures (detekt `ForbiddenImport` + `:core:verifyModuleBoundary`).
- API compatibility failures (checkKotlinAbi/updateKotlinAbi mismatch).
- Unit or integration regressions.
- Environment issues (JDK 21, Android SDK 35, Xcode, submodules).

## Workflow
1. Capture first failing task and first meaningful stack trace.
2. Classify into a triage bucket.
3. Propose smallest fix.
4. Re-run targeted task.
5. If green, expand to broader verification.
6. Summarize root cause and confidence level.

## Validation Commands
- ./gradlew <failingTask>
- ./gradlew detekt ktlintCheck
- ./gradlew checkKotlinAbi
- ./gradlew check

## Deliverable
Provide:
- root cause
- exact fix
- targeted reruns performed
- final status and remaining risk