ci-debug
Skill9 starsChanged 7 months agoApache-2.0View on GitHub
Debug GitHub Actions CI pipeline failures. Analyse les logs de workflow, identifie la cause racine et propose un fix.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- MoeenNehzati/famulustheir own version, first seen Jul 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- MoeenNehzati/famulus★ 4same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository27 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- cli/CLAUDE.mdCLAUDE.md
- control-plane-api/CLAUDE.mdCLAUDE.md
- control-plane-ui/CLAUDE.mdCLAUDE.md
- e2e/CLAUDE.mdCLAUDE.md
- portal/CLAUDE.mdCLAUDE.md
- stoa-gateway/CLAUDE.mdCLAUDE.md
- analyticsSkill
- cartoSkill
- ci-fixSkill
- competitive-watchSkill
- councilSkill
- decomposeSkill
- extractSkill
- fill-cycleSkill
- generate-backlogSkill
- impactSkill
- memory-consolidateSkill
- monitor-cdSkill
- parallel-reviewSkill
- pr-guardianSkill
- rewriteSkill
- roadmapSkill
- spec-drivenSkill
- sync-planSkill
- verify-megaSkill
The file
Files
CI Debug — Analyse des echecs CI
Contexte dynamique
- Checks PR en cours: !
gh pr checks 2>/dev/null | head -20 - Workflows recents: !
gh run list --limit 5 --json name,status,conclusion,headBranch --template '{{range .}}{{.name}} | {{.status}} | {{.conclusion}} | {{.headBranch}}{{"\n"}}{{end}}' 2>/dev/null
Instructions
Analyser l'echec CI pour: $ARGUMENTS
Step 1: Identifier le workflow en echec
Si c'est un numero de PR:
gh pr checks $0
gh run list --branch $(gh pr view $0 --json headRefName -q .headRefName) --limit 3Si c'est une URL de workflow run:
gh run view $0 --log-failedStep 2: Extraire les logs d'erreur
gh run view <run-id> --log-failed 2>&1 | head -100Chercher les patterns:
error,Error,ERRORFAIL,FAILEDexit code 1,exit code 2denied,forbidden,unauthorized
Step 3: Diagnostiquer
Causes frequentes dans STOA CI:
| Pipeline | Erreur frequente | Cause | Fix |
| Python CI | I001 import order | isort non respecte | ruff check --fix |
| Python CI | mypy type error | Type hints manquants | Ajouter les annotations |
| Node CI | vitest fail | Mock MSW manquant | Ajouter handler MSW |
| Node CI | eslint warnings | Max warnings depassé (0 pour UI, 20 pour portal) | Fixer les warnings |
| Docker | buildx fail | Cache layer miss ou multi-arch | Verifier --platform linux/amd64,linux/arm64 |
| Helm | helm lint fail | Values manquantes, indentation | Verifier values.yaml |
| Security | dependency-review | GitHub Advanced Security non active | Connu, non-bloquant |
| K8s deploy | kubectl apply fail | Selector immutable, Kyverno block | Voir .claude/docs/k8s-deploy.md |
| K8s deploy | rollout timeout | maxSurge/maxUnavailable deadlock | maxUnavailable: 1, maxSurge: 0 |
Step 4: Proposer le fix
Pour chaque erreur identifiee:
- Fichier exact a modifier (chemin complet)
- Diff propose (old → new)
- Commande de verification locale
- Impact sur les autres workflows
Step 5: Rapport
## CI Debug: [workflow-name] — [branch]
### Echec
- **Job**: [nom du job]
- **Step**: [nom du step]
- **Erreur**: [message d'erreur exact]
### Cause racine
[Explication]
### Fix propose
[Diff exact]
### Verification locale
```bash
[commande pour reproduire/verifier]Impact
[Autres workflows potentiellement impactes]
## Regles
- Toujours lire les logs complets avant de diagnostiquer
- Ne pas confondre: erreur intermittente vs erreur structurelle
- Si `dependency-review` echoue seul → ignorer (connu, GitHub Advanced Security)
- Si `container-scan` / `codeql` echoue seul → verifier si intermittent
- Toujours proposer une verification localeDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

