root-cause-analysis
/root-cause-analysis
Śledzi dokładną przyczynę potwierdzonego błędu w kodzie przed zaproponowaniem poprawki i zapisuje wynik w zgłoszeniu, bez edycji kodu.
- Autor
- arozumenko ↗
- Repozytorium
- sdlc-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Śledzi dokładną przyczynę potwierdzonego błędu w kodzie przed zaproponowaniem poprawki i zapisuje wynik w zgłoszeniu, bez edycji kodu.
Wyzwalacze z opisu
Oryginalny opis (EN)
Use when a bug has been reproduced or confirmed and needs its exact cause traced before a fix is proposed, or when the user says 'investigate issue'. Traces a bug to its exact cause in the codebase. Investigation only — reports the cause on the ticket; does not edit code.
Jak działa
- Platform & systems
- When to use
- Methodology — 4 phases
- You do NOT
- Related skills
Podgląd SKILL.md
---
name: root-cause-analysis
description: Use when a bug has been reproduced or confirmed and needs its exact cause traced before a fix is proposed, or when the user says 'investigate issue'. Traces a bug to its exact cause in the codebase. Investigation only — reports the cause on the ticket; does not edit code.
license: Apache-2.0
metadata:
authors:
- Artem Rozumenko <artem_rozumenko@epam.com>
version: "0.1.0"
---
# Root-Cause Analysis (RCA)
Trace a confirmed bug to its exact cause and produce a structured RCA
artifact. **Investigation only — you do NOT edit code, branch, or fix.**
## Platform & systems
The RCA report goes on the **tracker ticket** — the source of truth — using
the tracker scout recorded in `.agents/profile.md § Project systems`. The
`gh issue …` commands below are the **GitHub reference**; translate per
`.agents/workflow.md § Git host`. With no tracker, report directly to the user.
## When to use
Pairs with **`systematic-debugging`** — use its rigor (reproduce reliably,
condition-based waiting) to trace, then produce the structured report here.
## Methodology — 4 phases
### 1. Ticket acquisition
Read the ticket and all comments (reproduction steps, errors, stack traces,
environment, prior notes). Note that RCA has started on the ticket.
### 2. Codebase investigation — trace, don't guess
- **Locate the entry point**: grep the error message / function / route.
- **Trace the call chain**: entry (route/handler) → service (logic) → data
layer → failure point. Read each file in the chain.
- **Examine the failure point**: which assumption is violated? what input
triggers it? is the bug here or in a dependency?
- **Search for patterns**: how is the function called elsewhere; are there
similar patterns that work; `git blame` and recent `git log` on the file.
### 3. Root-cause determination
Classify the cause:
| Category | Description | Example |
|---|---|---|
| **Logic** | Wrong condition, missing branch, off-by-one | `if x > 0` should be `if x >= 0` |
| **Data** | Unexpected input, null handling, type mismatch | Missing null check on optional field |
| **Concurrency** | Race condition, missing lock, async issue | Two requests mutating the same resource |
| **Configuration** | Wrong default, missing env var | Timeout too low for large payloads |
| **Integration** | API contract / dependency version change | Third-party API changed its response shape |
| **Resource** | Memory, connection pool, file handles | DB connection pool exhausted |
State **confidence**: Confirmed (you can see the exact bug) / Highly likely /
Suspected.
### 4. Impact analysis & report
- **Usage**: what else calls the buggy code; what depends on the module.
- **Regression risk**: what could break if fixed; existing test coverage;
whether the code is shared across features.
- **Post the RCA report on the ticket**: executive summary, classification
(category / confidence / severity), root cause (location `file:line` +
function + cause + the offending code), execution path, impact analysis,
suggested remediation, and dependencies (what this blocks / relates to).
- **One line to user/PM**: root cause + location + confidence.
**RCA comment template:**
```
## Root Cause — <ticket-id>
**Summary:** <what & why, one paragraph>
**Classification:** <Logic|Data|Concurrency|Configuration|Integration|Resource> · confidence <Confirmed|Likely|Suspected> · severity <…>
**Root cause:** `path/to/file.ext:line` in `<function>` — <the offending logic>
**Execution path:** <entry → … → failure point>
**Impact:** <callers / regression risk / test coverage>
**Suggested remediation:** <fix direction, not the patch>
**Blocks / relates to:** <links>
```
## You do NOT
Edit source, create PRs/branches, run the app to fix it, make architecture
decisions, or close/reassign tickets. Hand the structured RCA to the developer
(or `bugfix-workflow`) for the fix.
## Related skills
- **`reproducing-issues`** precedes this — confirm the bug first.
- **`systematic-debugging`** for tracing rigor.
- **`bugfix-workflow`** consumes the RCA to implement and verify the fix.
Pliki w paczce (2)
- README.md 1 KB
- SKILL.md 4 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · arozumenko/sdlc-skills | 100 | MIT |
| qa-aman/claude-skills | 100 | MIT |
| robert-adunka/triz-skills | 100 | MIT |
| arjunprabhulal/devops-skills | 100 | MIT |
| static-var/keystone | 100 | MIT |
| rohitg00/skillkit | 100 | Apache-2.0 |
| microsoft/hve-core | 95 | MIT |
| VoDaiLocz/kilo-kit-mcp | 95 | Apache-2.0 |
| autohandai/code-cli | 90 | Apache-2.0 |
Migawka bazy z 13.11.2026 · wersja paczki 01d5e4b15517 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100rca-investigator
Prowadzi analizę przyczyn źródłowych potwierdzonego błędu: śledzi ścieżki kodu i zależności, wskazuje dokładne miejsce i przyczynę oraz dokumentuje ustalenia bez naprawiania kodu. - 100bug-investigation-notes
Prowadzi notatki z szukania błędu: objawy, kroki odtworzenia, hipotezy, przyczynę i test regresyjny. - 100om-root-cause
Diagnozuje w trybie tylko do odczytu potwierdzony błąd z trackera: lokalizuje przyczynę i zakres minimalnych zmian przed wdrożeniem. - 100triage
Bada błąd, znajduje jego przyczynę i zapisuje rekord triage z planem poprawki opartym na TDD. - 100triage-issue
Bada zgłoszony błąd do przyczyny źródłowej i tworzy plan poprawki w stylu TDD jako artefakt issue, zanim powstanie zmiana w kodzie. - 95triage-bug
Prowadzi błąd z Jiry od zgłoszenia do przyczyny źródłowej i tworzy zadanie naprawy z testem odtwarzającym problem.